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

Article
03/04/2024

La méthode EnumeratePreferredAddresses énumère les adresses préférées pour l’objet de téléphone. 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 C/C++. Visual Basic et les applications de script doivent utiliser la méthode get_Addresses .

Syntaxe

HRESULT EnumeratePreferredAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Paramètres

[out] ppEnumAddress

Pointeur vers un emplacement où, en cas de réussite, la méthode place un pointeur vers un objet d’énumération qui contient la liste des adresses. Pour plus d'informations, consultez la section Notes qui suit.

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 ppEnumAddress n’est pas un pointeur valide.
E_OUTOFMEMORY	Il n’y a pas assez de mémoire pour allouer l’objet énumération.

Remarques

Si aucune adresse utilisable n’est présente sur le système, cette méthode produit une énumération vide et retourne S_OK.

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 IEnumAddress retournée par ITPhone ::EnumeratePreferredAddresses. L’application doit appeler Release sur l’interface IEnumAddress pour libérer les ressources qui lui sont associées.