Freigeben über


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
S_OK
Methode war erfolgreich.
E_POINTER
Der pAddresses-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY
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

Weitere Informationen

EnumeratePreferredAddresses

ITAddress

ITPhone

get_Addresses

phoneGetID