Método IH323LineEx::SetAlias

[SetAlias no está disponible para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método SetAlias configura un alias H.323 predeterminado para la dirección. Este alias se usará en el intercambio de configuración de llamadas H.323 para que la otra parte conozca el nombre de esta entidad.

Al llamar a este método una segunda vez, se sobrescribirá el alias anterior.

El alias establecido en esta interfaz solo se usará cuando no haya ninguna otra manera para que el TSP encuentre un alias adecuado. En el futuro, cuando se agrega compatibilidad con gatekeeper en el TSP, el alias registrado en el gatekeeper o asignado por el gatekeeper invalidará lo que se establezca a través de este método.

Sintaxis

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

Parámetros

strAlias [in]

Alias que se va a usar, en Unicode. No se requiere terminación nula.

dwLength [in]

Longitud del nombre del alias en número de caracteres, incluido el terminador null .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El número de caracteres indicado en dwLength supera el número real de caracteres en el parámetro strAlias .

Requisitos

Requisito	Value
Versión de TAPI	Requiere TAPI 3.0 o posterior
Encabezado	H323priv.h
Biblioteca	Uuid.lib
Archivo DLL	Tapi3.dll