ITPhone::get_PreferredAddresses-Methode (tapi3if.h)

Artikel
03/02/2024

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.