Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |