Compartir a través de

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

  • Artículo

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.

Requisitos

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

Consulte también

Address (objeto)

IEnumLocation

ITAddressTranslation