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

  • Artigo

O método EnumerateLocations enumera os locais de endereço disponíveis no momento. Esse método é fornecido para aplicativos C e C++. Aplicativos cliente de automação, como aqueles escritos no Visual Basic, devem usar o método get_Locations .

Sintaxe

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

Parâmetros

[out] ppEnumLocation

Ponteiro para o objeto IEnumLocation criado.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 O método foi bem-sucedido.
E_POINTER
 O parâmetro ppEnumLocations não é um ponteiro válido.
E_OUTOFMEMORY
 Existe memória insuficiente para criar um objeto .

Comentários

O método EnumerateLocations é 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 IEnumLocationretornada por ITAddressTranslation::EnumerateLocations. O aplicativo deve chamar Release na interface IEnumLocation para liberar recursos associados a ele.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Objeto Address

IEnumLocation

ITAddressTranslation