ITPhone::get_Addresses-Methode (tapi3if.h)

Die get_Addresses-Methode gibt eine Sammlung von Adressen zurück, auf denen das Telefon verwendet werden kann. Die Anwendung muss itPhone::Open nicht aufrufen, bevor Sie diese Methode ausführen.

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 eine VARIANT, die eine ITCollection of ITAddress-Schnittstellenzeiger enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Ein Telefongerät deklariert sich selbst als verfügbar auf allen 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 mit phoneGetID mit 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, auf denen 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 Telefonobjekts das Telefon öffnen und phoneGetID während der TAPI-Initialisierung aufrufen kann oder wenn ein neues Telefonobjekt angezeigt wird.

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 ihnen zugeordnete Ressourcen freizugeben.

Anforderungen

   
Zielplattform Windows
Kopfzeile tapi3if.h (include Tapi3.h)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

ITPhone

get_PreferredAddresses