Método ITMedia::p ut_MediaName

[ Controles e interfaces de conferência de telefonia ip de reunião não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]

O método put_MediaName define o nome da mídia. Mídia definida são áudio, vídeo, quadro de comunicações, texto e dados.

Sintaxe

HRESULT put_MediaName(
  [in] BSTR pMediaName
);

Parâmetros

pMediaName [in]

Ponteiro para um BSTR que contém o nome da mídia a ser definido.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pMediaName não é um ponteiro válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
E_FAIL	Erro não especificado.
E_NOTIMPL	Este método ainda não foi implementado.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pMediaName e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Essa função pode enviar dados pela transmissão em formato não criptografado; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto não criptografado deve ser considerado antes de usar esse método.

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 3.0 ou posterior
Cabeçalho	Sdpblb.h
Biblioteca	Uuid.lib
DLL	Sdpblb.dll

Confira também

Itmedia

ITMedia::get_MediaName