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

  • Article

La méthode EnumerateTerminals récupère une énumération des terminaux associés au téléphone. L’application n’a pas besoin d’appeler ITPhone ::Open avant d’exécuter cette méthode.

Syntaxe

HRESULT EnumerateTerminals(
  [in]  ITAddress     *pAddress,
  [out] IEnumTerminal **ppEnumTerminal
);

Paramètres

[in] pAddress

Pointeur vers l’interface ITAddress .

[out] ppEnumTerminal

Pointeur vers l’interface IEnumTerminal qui énumère les terminaux.

Valeur retournée

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

Remarques

Si aucun terminal n’est associé au téléphone, cette méthode produit une énumération vide et retourne S_OK.

Bien que la fonction phoneGetID nécessite le handle pour un appareil téléphonique ouvert, l’application n’a pas besoin d’appeler la méthode ITPhone ::Open avant d’appeler EnumerateTerminals. Cela est dû au fait que l’implémentation de l’objet phone peut ouvrir le téléphone et appeler phoneGetID pendant l’initialisation TAPI ou lorsqu’un nouvel objet téléphonique apparaît.

TAPI appelle la méthode AddRef sur l’interface IEnumTerminal retournée par ITPhone ::EnumerateTerminals. L’application doit appeler Release sur l’interface IEnumTerminal 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

IEnumTerminal

ITAddress

ITPhone