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

Artículo
08/26/2023

El método EnumerateAddresses enumera las direcciones que están disponibles actualmente. Se proporciona para aplicaciones de C y C++. Las aplicaciones cliente de Automation, como las escritas en Visual Basic, deben usar el método get_Addresses .

Sintaxis

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parámetros

[out] ppEnumAddress

Puntero a la interfaz IEnumAddress .

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 ppEnumAddress no es un puntero válido.
E_INVALIDARG	El objeto TAPI no se ha inicializado.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

Normalmente, una aplicación usa esta enumeración para comprobar las funcionalidades de cada dirección y determinar cuáles son útiles para fines actuales.

Si no se encuentra una dirección esperada, esto puede indicar que el proveedor de servicios adecuado no se ha instalado o no funciona correctamente.

TAPI llama al método Addref en la interfaz IEnumAddress devuelta por ITTAPI::EnumerateAddresses. La aplicación debe llamar al método Release en la interfaz IEnumAddress para liberar recursos asociados a él.

Si se crea o quita una dirección durante una sesión TAPI, se notificará a la aplicación a través de la interfaz ITTAPIEventNotification . Si se ha creado una dirección, como al instalar un dispositivo Plug and Play, itTAPIEventNotification::Event devuelve el miembro TE_ADDRESSCREATE de la enumeración TAPIOBJECT_EVENT. Si se quita una dirección, ITTAPIEventNotification::Event devuelve TE_ADDRESSREMOVE. La llamada a EnumerateAddresses después de estos eventos reflejará las direcciones actuales.