ITPhone ::EnumerateAddresses, méthode (tapi3if.h)
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 |