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

Article
03/02/2024

La méthode get_PreferredAddresses retourne une collection d’adresses sur laquelle le téléphone est préféré pour une utilisation. 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++ trouveront plus pratique d’utiliser la méthode EnumerateAddresses .

Syntaxe

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Paramètres

[out] pAddresses

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

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre pAddresses n’est pas un pointeur valide.
E_OUTOFMEMORY	Il n’y a pas assez de mémoire pour allouer l’objet de collection.

Remarques

Si aucune adresse utilisable n’est présente sur le système, cette méthode retourne une collection vide.

Un appareil téléphonique se déclare préféré à une adresse ou à un ensemble d’adresses en retournant des ID d’adresse/ligne à l’aide de la fonction phoneGetID TAPI 2.x 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 EnumeratePreferredAddresses. 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_PreferredAddresses. L’application doit appeler Release sur l’interface ITAddress pour libérer les ressources qui lui sont associées.