Compartilhar via


Método IH323LineEx::SetAlias

[SetAlias não está disponível 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 SetAlias configura um alias H.323 padrão para o endereço. Esse alias será usado na troca de configuração de chamada H.323 para que a outra parte saiba o nome dessa parte.

Chamar esse método uma segunda vez substituirá o alias anterior.

O alias definido nessa interface será usado somente quando não houver outra maneira de o TSP encontrar um alias adequado. No futuro, quando o suporte do gatekeeper for adicionado ao TSP, o alias registrado ao gatekeeper ou atribuído pelo gatekeeper substituirá o que for definido por meio desse método.

Sintaxe

HRESULT SetAlias(
  [in] WCHAR *strAlias,
  [in] DWORD dwLength
);

Parâmetros

strAlias [in]

O alias a ser usado, em Unicode. A terminação nula não é necessária.

dwLength [in]

O comprimento do nome do alias no número de caracteres, incluindo o terminador nulo .

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 número de caracteres indicados em dwLength excede o número real de caracteres no parâmetro strAlias .

Requisitos

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