Método ITPhone::get_PreferredAddresses (tapi3if.h)

Artículo
03/13/2024

El método get_PreferredAddresses devuelve una colección de direcciones en las que se prefiere el teléfono para su uso. La aplicación no tiene que llamar a ITPhone::Open antes de ejecutar este método.

Este método está diseñado para Visual Basic y aplicaciones de scripting. Las aplicaciones de C/C++ le resultarán más conveniente usar el método EnumerateAddresses .

Sintaxis

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Parámetros

[out] pAddresses

Puntero a una VARIANTE que contiene una ITCollection de punteros de interfaz ITAddress .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pAddresses no es un puntero válido.
E_OUTOFMEMORY	No hay suficiente memoria para asignar el objeto de colección.

Comentarios

Si no hay direcciones utilizables en el sistema, este método devuelve una colección vacía.

Un dispositivo telefónico se declara como preferido para una dirección o un conjunto de direcciones devolviendo identificadores de dirección/línea mediante la función phoneGetID tapi/line de TAPI 2.x con la clase de dispositivo tapi/line.

Aunque la función phoneGetID requiere el identificador para un dispositivo telefónico abierto, la aplicación no tiene que llamar al método ITPhone::Open antes de llamar a EnumeratePreferredAddresses. Esto se debe a que la implementación del objeto phone puede abrir el teléfono y llamar a phoneGetID durante la inicialización tapi o cuando aparece un nuevo objeto de teléfono.

TAPI llama al método AddRef en la interfaz ITAddress devuelta por ITPhone::get_PreferredAddresses. La aplicación debe llamar a Release en la interfaz ITAddress para liberar recursos asociados a él.