Método ITAddressTranslation::EnumerateLocations (tapi3if.h)

Artículo
03/02/2024

El método EnumerateLocations enumera las ubicaciones de direcciones disponibles actualmente. Este método 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_Locations .

Sintaxis

HRESULT EnumerateLocations(
  [out] IEnumLocation **ppEnumLocation
);

Parámetros

[out] ppEnumLocation

Puntero al objeto IEnumLocation creado.

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 ppEnumLocations no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para crear un objeto.

Comentarios

El método EnumerateLocations es un contenedor COM para la función LineGetTranslateCaps de TAPI 2.1 y toma información de ubicación de la estructura LINETRANSLATECAPS devuelta por esa función.

TAPI llama al método AddRef en la interfaz IEnumLocation devuelta por ITAddressTranslation::EnumerateLocations. La aplicación debe llamar a Release en la interfaz IEnumLocation para liberar recursos asociados a él.