ITPhone::get_Terminals-Methode (tapi3if.h)
Die get_Terminals-Methode ruft eine Sammlung von Terminals ab, die dem Telefon zugeordnet sind. Die Anwendung muss itPhone::Open nicht aufrufen, bevor diese Methode ausgeführt wird.
Syntax
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
Parameter
[in] pAddress
Zeiger auf die ITAddress-Schnittstelle .
[out] pTerminals
Zeiger auf einen VARIANT-Wert , der eine ITCollection von ITTerminal-Schnittstellenzeigern enthält.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn dem Telefon keine Terminals zugeordnet sind, erzeugt diese Methode eine leere Sammlung und gibt S_OK zurück.
Die Anwendung muss nicht die ITPhone::Open-Methode aufrufen, bevor get_Terminals aufgerufen wird. Dies liegt daran, dass die Implementierung des phone-Objekts das Telefon öffnen und phoneGetID während der TAPI-Initialisierung oder beim Anzeigen eines neuen Telefonobjekts aufrufen kann.
TAPI ruft die AddRef-Methode auf der ITAddress-Schnittstelle auf, die von ITPhone::get_Terminals zurückgegeben wird. Die Anwendung muss Release auf der ITAddress-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |