MÉTHODE ITAddressCapabilities ::get_AddressCapabilityString (tapi3if.h)

Article
03/04/2024

La méthode get_AddressCapabilityString obtient la chaîne de capacité d’un ADDRESS_CAPABILITY_STRING donné.

Syntaxe

HRESULT get_AddressCapabilityString(
  [in]  ADDRESS_CAPABILITY_STRING AddressCapString,
  [out] BSTR                      *ppCapabilityString
);

Paramètres

[in] AddressCapString

Descripteur pour la chaîne de capacité d’adresse souhaitée.

[out] ppCapabilityString

Pointeur vers la valeur BSTR de la fonctionnalité d’adresse. NULL est une valeur de retour possible si le TSP ne fournit pas de valeur pour AddressCapString.

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_INVALIDARG	Le paramètre AddressCapString n’est pas valide.
E_POINTER	Le paramètre ppCapabilityString n’est pas un pointeur valide.
TAPI_E_NOTSUPPORTED	La version TAPI n’est pas 3.0 ou ultérieure.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

L’application doit utiliser SysFreeString pour libérer la mémoire allouée au paramètre ppCapabilityString .

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi3if.h (inclure Tapi3.h)
Bibliothèque	Uuid.lib
DLL	Tapi3.dll

Voir aussi

ADDRESS_CAPABILITY_STRING

Objet Address

ITAddressCapabilities

Partager via