Méthode ITTAPI ::EnumerateAddresses (tapi3if.h)
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 |
---|---|
|
La méthode a réussi. |
|
Le paramètre ppEnumAddress n’est pas un pointeur valide. |
|
L’objet TAPI n’a pas été initialisé. |
|
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.
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour