Méthode ITTAPI ::EnumerateAddresses (tapi3if.h)

Article
03/02/2024

La méthode EnumerateAddresses énumère les adresses actuellement disponibles. Fourni pour les applications C et C++. Les applications clientes Automation, telles que celles écrites en Visual Basic, doivent utiliser la méthode get_Addresses .

Syntaxe

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Paramètres

[out] ppEnumAddress

Pointeur vers l’interface IEnumAddress .

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre ppEnumAddress n’est pas un pointeur valide.
E_INVALIDARG	L’objet TAPI n’a pas été initialisé.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

Une application utilise généralement cette énumération pour case activée les fonctionnalités de chaque adresse et déterminer celles qui sont utiles aux fins actuelles.

Si une adresse attendue est introuvable, cela peut indiquer que le fournisseur de services approprié n’a pas été installé ou ne fonctionne pas correctement.

TAPI appelle la méthode Addref sur l’interface IEnumAddress retournée par ITTAPI ::EnumerateAddresses. L’application doit appeler la méthode Release sur l’interface IEnumAddress pour libérer les ressources qui lui sont associées.

Si une adresse est créée ou supprimée pendant une session TAPI, l’application est avertie via l’interface ITTAPIEventNotification . Si une adresse a été créée, par exemple en installant un appareil Plug-and-Play, ITTAPIEventNotification ::Event retourne le TE_ADDRESSCREATE membre de l’énumération TAPIOBJECT_EVENT. Si une adresse est supprimée, ITTAPIEventNotification ::Event retourne TE_ADDRESSREMOVE. L’appel d’EnumerateAddresses après ces événements reflète les adresses actuelles.