ITPhone ::EnumerateAddresses, méthode (tapi3if.h)

  • Article

La méthode EnumerateAddresses énumère les adresses sur laquelle le téléphone peut être utilisé. L’application n’a pas besoin d’appeler ITPhone ::Open avant d’exécuter cette méthode.

Cette méthode est destinée aux applications C/C++. Visual Basic et les applications de script 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

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si aucun téléphone n’est disponible pour une utilisation avec l’adresse, cette méthode produit une énumération vide et retourne S_OK.

Un appareil téléphonique se déclare disponible sur toutes les adresses qui prennent en charge les terminaux audio par le paramètre TSP PHONEFEATURE_GENERICPHONE bit dans le membre dwPhoneFeatures de la structure PHONECAPS . Un appareil téléphonique peut également se déclarer préféré à une adresse ou à un ensemble d’adresses en retournant des ID d’adresse/ligne à l’aide de phoneGetID avec la classe d’appareil tapi/ligne. La méthode EnumerateAddresses retourne les adresses qui ont été identifiées dans les deux sens.

Pour obtenir uniquement les adresses sur lesquelles le téléphone est préféré, vous pouvez appeler la méthode EnumeratePreferredAddresses .

Un appareil téléphonique se déclare spécifique à une adresse ou à un ensemble d’adresses en retournant des ID d’adresse/ligne à l’aide de phoneGetID avec la classe d’appareil tapi/ligne. Bien que la fonction phoneGetID nécessite le handle sur un appareil téléphonique ouvert, l’application n’a pas besoin d’appeler la méthode ITPhone ::Open avant d’appeler EnumerateAddresses. Cela est dû au fait que l’implémentation de l’objet téléphone peut ouvrir le téléphone et appeler phoneGetID lors de l’initialisation TAPI ou lorsqu’un nouvel objet téléphonique apparaît.

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

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

EnumeratePreferredAddresses

ITPhone