ITAddress2::get_Phones-Methode (tapi3if.h)
Die get_Phones-Methode gibt einen VARIANT-Zeiger auf eine ITCollection von Telefonobjekten zurück, die den Telefongeräten entsprechen, die mit dieser Adresse verwendet werden können.
Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. C/C++-Anwendungen sollten stattdessen die EnumeratePhones-Methode verwenden.
Syntax
HRESULT get_Phones(
[out] VARIANT *pPhones
);
Parameter
[out] pPhones
Zeiger auf einen VARIANT-Wert, der eine ITCollection mit ITPhone-Schnittstellenzeigern enthält.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Ein Telefongerät deklariert sich selbst als verfügbar für alle Adressen, die Audioterminals unterstützen, indem der TSP das PHONEFEATURE_GENERICPHONE Bit im dwPhoneFeatures-Element der PHONECAPS-Struktur festlegt. Ein Telefongerät kann sich auch als bevorzugt für eine Adresse oder einen Satz von Adressen deklarieren, indem es Adressen-/Zeilen-IDs über phoneGetID mit der Geräteklasse tapi/line zurückgibt. Wenn keine Telefone für die Verwendung mit der Adresse verfügbar sind, erzeugt diese Methode eine leere Auflistung und gibt S_OK zurück.
TAPI ruft die AddRef-Methode auf der ITPhone-Schnittstelle auf, die von ITAddress2::get_Phones zurückgegeben wird. Die Anwendung muss Release auf der ITPhone-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |