ITPhone::get_Terminals méthode (tapi3if.h)

Article
08/26/2023

La méthode get_Terminals récupère une collection de 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 get_Terminals(
  [in]  ITAddress *pAddress,
  [out] VARIANT   *pTerminals
);

Paramètres

[in] pAddress

Pointeur vers l’interface ITAddress .

[out] pTerminals

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

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 collection vide et retourne S_OK.

L’application n’a pas besoin d’appeler la méthode ITPhone::Open avant d’appeler get_Terminals. 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 ITAddress retournée par ITPhone::get_Terminals. L’application doit appeler Release sur l’interface ITAddress pour libérer les ressources qui lui sont associées.