IH323LineEx::SetAlias-Methode

[SetAlias ist nicht für die Verwendung in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

Die SetAlias-Methode konfiguriert einen H.323-Standardalias für die Adresse. Dieser Alias wird im Setupaustausch für H.323-Aufrufe verwendet, sodass die andere Partei den Namen dieser Partei kennt.

Wenn Sie diese Methode ein zweites Mal aufrufen, wird der vorherige Alias überschrieben.

Der für diese Schnittstelle festgelegte Alias wird nur verwendet, wenn es keine andere Möglichkeit für den TSP gibt, einen richtigen Alias zu finden. Wenn in Zukunft die Gatekeeper-Unterstützung dem TSP hinzugefügt wird, überschreibt der Alias, der für den Gatekeeper registriert oder vom Gatekeeper zugewiesen wird, alles, was über diese Methode festgelegt wird.

Syntax

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

Parameter

strAlias [in]

Der zu verwendende Alias in Unicode. Null-Beendigung ist nicht erforderlich.

dwLength [in]

Die Länge des Aliasnamens in Anzahl von Zeichen, einschließlich des NULL-Abschlussators .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Die in dwLength angegebene Anzahl von Zeichen übersteigt die tatsächliche Anzahl von Zeichen im strAlias-Parameter .

Anforderungen

Anforderung	Wert
TAPI-Version	Erfordert TAPI 3.0 oder höher
Header	H323priv.h
Bibliothek	Uuid.lib
DLL	Tapi3.dll