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

Artigo
08/26/2023

O método get_Locations cria uma coleção de locais de endereço disponíveis no momento. Esse método é fornecido para aplicativos cliente de Automação, como aqueles escritos no Visual Basic. Os aplicativos C e C++ devem usar o método EnumerateLocations .

Sintaxe

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

Parâmetros

[out] pVariant

Ponteiro para VARIANT que contém uma ITCollection de ponteiros de interface ITLocationInfo (objetos de localização).

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pVariant não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

O método get_Locations é um wrapper COM para a função LINEGetTranslateCaps do TAPI 2.1 e obtém informações de localização da estrutura LINETRANSLATECAPS retornada por essa função.

O TAPI chama o método AddRef na interface ITLocationInforetornada por ITAddressTranslation::get_Locations. O aplicativo deve chamar Release na interface ITLocationInfo para liberar recursos associados a ele.