ITPhone::get_Addresses-Methode (tapi3if.h)

  • Artikel

Die get_Addresses-Methode gibt eine Auflistung von Adressen zurück, für die das Telefon verwendet werden kann. Die Anwendung muss itPhone::Open nicht aufrufen, bevor diese Methode ausgeführt wird.

Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. C/C++-Anwendungen sollten stattdessen die EnumerateAddresses-Methode verwenden.

Syntax

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

Parameter

[out] pAddresses

Zeiger auf einen VARIANT-Wert, der eine ITCollection mit ITAddress-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 adress-/zeilen-IDs mithilfe von phoneGetID mit der Geräteklasse tapi/line zurückgegeben werden. Die get_Addresses-Methode gibt Adressen zurück, die auf beide Arten identifiziert wurden.

Um nur Adressen abzurufen, für die das Telefon bevorzugt wird, können Sie die get_PreferredAddresses-Methode aufrufen.

Die Anwendung muss die ITPhone::Open-Methode nicht aufrufen, bevor get_Addresses 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_Addresses zurückgegeben wird. Die Anwendung muss Release auf der ITAddress-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

ITPhone

get_PreferredAddresses