ITPhone::EnumerateTerminals-Methode (tapi3if.h)

  • Artikel

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

Weitere Informationen

IEnumTerminal

ITAddress

ITPhone