Compartir a través de

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

  • Artículo

El método EnumeratePreferredPhones enumera los objetos de teléfono preferidos para 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_PreferredPhones .

Sintaxis

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

Parámetros

[out] ppEnumPhone

Puntero a la ubicación donde, si se ejecuta correctamente, este método colocará un puntero a un objeto de enumeración que contiene la lista de teléfonos devuelta.

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
 No hay suficiente memoria para asignar el objeto de enumeración.

Comentarios

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 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::EnumeratePreferredPhones. La aplicación debe llamar a Release en la interfaz IEnumPhone para liberar recursos asociados a él.

Requisitos

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

Consulte también

IEnumPhone

ITAddress2