IH323LineEx::SetAlias, méthode

[SetAlias n’est pas disponible pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC fournit des fonctionnalités similaires.]

La méthode SetAlias configure un alias H.323 par défaut pour l’adresse. Cet alias sera utilisé dans l’échange de configuration d’appel H.323 afin que l’autre partie connaisse le nom de ce tiers.

L’appel de cette méthode une deuxième fois remplace l’alias précédent.

L’alias défini sur cette interface est utilisé uniquement lorsqu’il n’existe aucun autre moyen pour le fournisseur de services de sécurité de trouver un alias approprié. À l’avenir, lorsque la prise en charge du gardien de contrôle est ajoutée au fournisseur de services TSP, l’alias inscrit au gardien de contrôle ou affecté par le gardien de contrôle remplacera tout ce qui est défini par cette méthode.

Syntaxe

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

Paramètres

strAlias [in]

Alias à utiliser, en Unicode. L’arrêt Null n’est pas obligatoire.

dwLength [in]

Longueur du nom d’alias en nombre de caractères, y compris la marque de fin Null .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_POINTER	Le nombre de caractères indiqué dans dwLength dépasse le nombre réel de caractères dans le paramètre strAlias .

Spécifications

Condition requise	Valeur
Version TAPI	Nécessite TAPI 3.0 ou version ultérieure
En-tête	H323priv.h
Bibliothèque	Uuid.lib
DLL	Tapi3.dll