ITPhone::get_Terminals-Methode (tapi3if.h)

Artikel
08/26/2023

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.