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

Artículo
03/08/2023

El método get_Locations crea una colección de ubicaciones de direcciones disponibles actualmente. Este método se proporciona para las aplicaciones cliente de Automation, como las escritas en Visual Basic. Las aplicaciones de C y C++ deben usar el método EnumerateLocations .

Sintaxis

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

Parámetros

[out] pVariant

Puntero a VARIANT que contiene una ITCollection de punteros de interfaz ITLocationInfo (objetos de ubicación).

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 pVariant no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

El método get_Locations 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 ITLocationInfo devuelta por ITAddressTranslation::get_Locations. La aplicación debe llamar a Release en la interfaz ITLocationInfo para liberar recursos asociados a él.