ITPhone::get_Addresses-Methode (tapi3if.h)
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.
HRESULT get_Addresses(
[out] VARIANT *pAddresses
);
[out] pAddresses
Zeiger auf einen VARIANT-Wert, der eine ITCollection mit ITAddress-Schnittstellenzeigern enthält.
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
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.
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |