Compartir a través de


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

El método EnumerateAddresses enumera las direcciones en las que se puede usar el teléfono. 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 EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parámetros

[out] ppEnumAddress

Puntero a la interfaz IEnumAddress .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si no hay teléfonos disponibles para su uso con la dirección, este método genera una enumeración vacía y devuelve S_OK.

Un dispositivo telefónico se declara como disponible en todas las direcciones que admiten terminales de audio mediante el TSP estableciendo el bit PHONEFEATURE_GENERICPHONE en el miembro dwPhoneFeatures de la estructura PHONECAPS . Un dispositivo telefónico también puede declararse como preferido para una dirección o un conjunto de direcciones devolviendo identificadores de dirección/línea mediante phoneGetID con la clase de dispositivo tapi/line. El método EnumerateAddresses devuelve direcciones que se han identificado de ambas maneras.

Para obtener solo las direcciones en las que se prefiere el teléfono, puede llamar al método EnumeratePreferredAddresses .

Un dispositivo telefónico se declara como específico de una dirección o un conjunto de direcciones devolviendo identificadores de dirección/línea mediante phoneGetID 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 EnumerateAddresses. 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::EnumerateAddresses. La aplicación debe llamar a Release en la interfaz IEnumAddress para liberar recursos asociados a él.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3if.h (include Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

EnumeratePreferredAddresses

ITPhone