ITAddress2 ::get_Phones, méthode (tapi3if.h)
La méthode get_Phones retourne un pointeur VARIANT vers un ITCollection d’objets téléphoniques correspondant aux appareils téléphoniques qui peuvent être utilisés avec cette adresse.
Cette méthode est destinée aux applications Visual Basic et de script. Les applications C/C++ doivent utiliser la méthode EnumeratePhones à la place.
Syntaxe
HRESULT get_Phones(
[out] VARIANT *pPhones
);
Paramètres
[out] pPhones
Pointeur vers un VARIANT contenant un ITCollection de pointeurs d’interface ITPhone .
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 via phoneGetID avec la classe d’appareil tapi/ligne. Si aucun téléphone n’est disponible pour une utilisation avec l’adresse, cette méthode génère une collection vide et retourne S_OK.
TAPI appelle la méthode AddRef sur l’interface ITPhone retournée par ITAddress2 ::get_Phones. L’application doit appeler Release sur l’interface ITPhone 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 |