ITAddress2::EnumeratePhones-Methode (tapi3if.h)
Die EnumeratePhones-Methode listet die Telefonobjekte auf, die den Telefongeräten entsprechen, die mit dieser Adresse verwendet werden können.
Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen müssen die get_Phones-Methode verwenden.
Syntax
HRESULT EnumeratePhones(
[out] IEnumPhone **ppEnumPhone
);
Parameter
[out] ppEnumPhone
Zeiger auf die neue IEnumPhone-Schnittstelle .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der ppEnumPhone-Parameter ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Fehler bei der Methode aus unbekannten Gründen. |
Hinweise
Ein Telefongerät deklariert sich als verfügbar für alle Adressen, die Audioterminals unterstützen, indem der TSP das PHONEFEATURE_GENERICPHONE Bit im dwPhoneFeatures-Member der PHONECAPS-Struktur festlegt. Ein Telefongerät kann sich auch als bevorzugt für eine Adresse oder einen Adresssatz deklarieren, indem Adress-/Leitungs-IDs mithilfe von phoneGetID mit der Geräteklasse tapi/line zurückgegeben werden. Wenn keine Telefone für die Verwendung mit der Adresse verfügbar sind, erzeugt diese Methode eine leere Enumeration und gibt S_OK zurück.
TAPI ruft die AddRef-Methode auf der IEnumPhone-Schnittstelle auf, die von ITAddress2::EnumeratePhones zurückgegeben wird. Die Anwendung muss Release auf der IEnumPhone-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |