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

Artículo
03/02/2024

El método EnumeratePreferredAddresses enumera las direcciones preferidas para el objeto phone. La aplicación no tiene que llamar a ITPhone::Open antes de ejecutar este método.

Este método está pensado para aplicaciones de C/C++. Visual Basic y las aplicaciones de scripting deben usar el método get_Addresses .

Sintaxis

HRESULT EnumeratePreferredAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parámetros

[out] ppEnumAddress

Puntero a una ubicación donde, si se ejecuta correctamente, el método coloca un puntero a un objeto de enumeración que contiene la lista de direcciones. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

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 ppEnumAddress no es un puntero válido.
E_OUTOFMEMORY	No hay suficiente memoria para asignar el objeto de enumeración.

Comentarios

Si no hay direcciones utilizables presentes en el sistema, este método genera una enumeración vacía y devuelve S_OK.

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 IEnumAddress devuelta por ITPhone::EnumeratePreferredAddresses. La aplicación debe llamar a Release en la interfaz IEnumAddress para liberar recursos asociados a él.