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 |