ITAddress2::EnumeratePreferredPhones, méthode (tapi3if.h)
La méthode EnumeratePreferredPhones énumère les objets téléphoniques préférés pour cette adresse.
Cette méthode est destinée aux applications C/C++. Visual Basic et les applications de script doivent utiliser la méthode get_PreferredPhones .
Syntaxe
HRESULT EnumeratePreferredPhones(
[out] IEnumPhone **ppEnumPhone
);
Paramètres
[out] ppEnumPhone
Pointeur vers l’emplacement où, en cas de réussite, cette méthode placera un pointeur vers un objet d’énumération qui contient la liste retournée des téléphones.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre ppEnumPhone n’est pas un pointeur valide. |
|
Il n’y a pas assez de mémoire pour allouer l’objet énumération. |
Remarques
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 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 produit une énumération vide et retourne S_OK.
TAPI appelle la méthode AddRef sur l’interface IEnumPhone retournée par ITAddress2::EnumeratePreferredPhones. L’application doit appeler Release sur l’interface IEnumPhone pour libérer les ressources qui lui sont associées.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |