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 |