ITPhone::EnumerateTerminals-Methode (tapi3if.h)
Die EnumerateTerminals-Methode ruft eine Enumeration von Terminals ab, die dem Telefon zugeordnet sind. Die Anwendung muss itPhone::Open nicht aufrufen, bevor diese Methode ausgeführt wird.
Syntax
HRESULT EnumerateTerminals(
[in] ITAddress *pAddress,
[out] IEnumTerminal **ppEnumTerminal
);
Parameter
[in] pAddress
Zeiger auf die ITAddress-Schnittstelle .
[out] ppEnumTerminal
Zeiger auf die IEnumTerminal-Schnittstelle , die Terminals aufzählt.
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 Enumeration und gibt S_OK zurück.
Obwohl die phoneGetID-Funktion das Handle für ein geöffnetes Telefongerät erfordert, muss die Anwendung nicht die ITPhone::Open-Methode aufrufen, bevor sie EnumerateTerminals aufruft. Dies liegt daran, dass die Implementierung des Telefonobjekts 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 IEnumTerminal-Schnittstelle auf, die von ITPhone::EnumerateTerminals zurückgegeben wird. Die Anwendung muss Release auf der IEnumTerminal-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |