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

  • Article

La méthode get_Addresses retourne une collection d’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 Visual Basic et de script. Les applications C/C++ doivent utiliser la méthode EnumerateAddresses à la place.

Syntaxe

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

Paramètres

[out] pAddresses

Pointeur vers un VARIANT contenant un ITCollection de pointeurs d’interface ITAddress .

Valeur retournée

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

Remarques

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 get_Addresses 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 get_PreferredAddresses .

L’application n’a pas besoin d’appeler la méthode ITPhone ::Open avant d’appeler get_Addresses. 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 ITAddress retournée par ITPhone ::get_Addresses. L’application doit appeler Release sur l’interface ITAddress 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

ITPhone

get_PreferredAddresses