ITAddress2::get_Phones-Methode (tapi3if.h)

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

Weitere Informationen

EnumeratePhones

ITAddress2