Compartir a través de

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

  • Artículo

El método get_PreferredPhones devuelve una colección de objetos de teléfono correspondientes a los dispositivos telefónicos preferidos para su uso con esta dirección.

Este método está diseñado para Visual Basic y aplicaciones de scripting. En su lugar, las aplicaciones de C/C++ deben usar el método EnumeratePreferredPhones .

Sintaxis

HRESULT get_PreferredPhones(
  [out] VARIANT *pPhones
);

Parámetros

[out] pPhones

Puntero a una VARIANT que contiene un ITCollection de punteros de interfaz itPhone .

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 pPhones no es un puntero válido.
E_OUTOFMEMORY
 No hay suficiente memoria para asignar el objeto de colecció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 esta dirección, el método genera una colección vacía y devuelve S_OK.

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

ITAddress2

ITPhone