Compartilhar via


Método ITSdp::p ut_MachineAddress

[ Controles e interfaces de conferência de telefonia ip de encontro 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_MachineAddress define o endereço do computador do host de origem.

Sintaxe

HRESULT put_MachineAddress(
  [in] BSTR pMachineAddress
);

Parâmetros

pMachineAddress [in]

Ponteiro para um BSTR que contém o endereço do computador do host da conferência.

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 pMachineAddress não é um ponteiro válido.
E_OUTOFMEMORY
Há 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 pMachineAddress e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

O parâmetro pMachineAddress pode ser um nome DNS ("JohnSmith.workinghard.microsoft.com") ou um endereço IP ("10.111.222.111").

Essa função pode enviar dados sobre o fio em forma não criptografada; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto claro 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

ITSdp

ITSdp::get_MachineAddress