Compartir a través de

Método ITAddress2::EnumeratePhones (tapi3if.h)

  • Artículo

El método EnumeratePhones enumera los objetos de teléfono correspondientes a los dispositivos telefónicos que se pueden usar con esta dirección.

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

Sintaxis

HRESULT EnumeratePhones(
  [out] IEnumPhone **ppEnumPhone
);

Parámetros

[out] ppEnumPhone

Puntero a la nueva interfaz IEnumPhone .

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 ppEnumPhone no es un puntero válido.
E_OUTOFMEMORY
 Existe memoria insuficiente para realizar la operación.
E_UNEXPECTED
 Error en el método por motivos desconocidos.

Comentarios

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. 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.

TAPI llama al método AddRef en la interfaz IEnumPhone devuelta por ITAddress2::EnumeratePhones. La aplicación debe llamar a Release en la interfaz IEnumPhone 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

IEnumPhone

ITAddress2