ITPhone::get_PreferredAddresses-Methode (tapi3if.h)
Die get_PreferredAddresses-Methode gibt eine Auflistung von Adressen zurück, für die das Telefon bevorzugt verwendet wird. Die Anwendung muss itPhone::Open nicht aufrufen, bevor diese Methode ausgeführt wird.
Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. Für C/C++-Anwendungen ist es bequemer, die EnumerateAddresses-Methode zu verwenden.
Syntax
HRESULT get_PreferredAddresses(
[out] VARIANT *pAddresses
);
Parameter
[out] pAddresses
Zeiger auf einen VARIANT-Wert , der eine ITCollection mit ITAddress-Schnittstellenzeigern enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der pAddresses-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um das Auflistungsobjekt zuzuweisen. |
Hinweise
Wenn keine verwendbaren Adressen im System vorhanden sind, gibt diese Methode eine leere Auflistung zurück.
Ein Telefongerät deklariert sich als bevorzugt gegenüber einer Adresse oder einem Adresssatz, indem Adress-/Zeilen-IDs mithilfe der TAPI 2.x phoneGetID-Funktion mit der Geräteklasse tapi/line zurückgegeben werden.
Obwohl die phoneGetID-Funktion das Handle für ein geöffnetes Telefongerät erfordert, muss die Anwendung nicht die ITPhone::Open-Methode aufrufen, bevor sie EnumeratePreferredAddresses aufruft. Dies liegt daran, dass die Implementierung des Telefonobjekts 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 VON ITPhone::get_PreferredAddresses zurückgegebenen ITAddress-Schnittstelle auf. Die Anwendung muss Release auf der ITAddress-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |