ITAddress2 ::EnumeratePhones, méthode (tapi3if.h)
La méthode EnumeratePhones énumère les objets téléphoniques correspondant aux appareils téléphoniques qui peuvent être utilisés avec 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_Phones .
Syntaxe
HRESULT EnumeratePhones(
[out] IEnumPhone **ppEnumPhone
);
Paramètres
[out] ppEnumPhone
Pointeur vers la nouvelle interface IEnumPhone .
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. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
La méthode a échoué pour des raisons inconnues. |
Remarques
Un appareil téléphonique se déclare disponible sur toutes les adresses qui prennent en charge les terminaux audio par le paramètre TSP PHONEFEATURE_GENERICPHONE bit dans le membre dwPhoneFeatures de la structure PHONECAPS . Un appareil téléphonique peut également se déclarer 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 ::EnumeratePhones. L’application doit appeler Release sur l’interface IEnumPhone 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 |