ITAddress2 ::get_PreferredPhones méthode (tapi3if.h)
La méthode get_PreferredPhones renvoie une collection d’objets téléphoniques correspondant aux appareils téléphoniques qui sont préférés pour une utilisation avec cette adresse.
Cette méthode est destinée aux applications Visual Basic et de script. Les applications C/C++ doivent utiliser la méthode EnumeratePreferredPhones à la place.
Syntaxe
HRESULT get_PreferredPhones(
[out] VARIANT *pPhones
);
Paramètres
[out] pPhones
Pointeur vers un VARIANT contenant un ITCollection de pointeurs d’interface ITPhone .
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre pPhones n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour allouer l’objet de collection. |
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/de ligne à l’aide de phoneGetID avec la classe d’appareil tapi/ligne. Si aucun téléphone n’est disponible avec cette adresse, la méthode produit une collection vide et retourne S_OK.
TAPI appelle la méthode AddRef sur l’interface ITPhone retournée par ITAddress2 ::get_PreferredPhones. L’application doit appeler Release sur l’interface ITPhone 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 |