Compartilhar via


Método ILatLongReport::GetAltitude (locationapi.h)

[A API de Localização do Win32 está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use a API Windows.Devices.Geolocation . ]

Recupera a altitude, em metros. Altitude é relativa ao elipsoide de referência.

Sintaxe

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Parâmetros

[out] pAltitude

Endereço de um DOUBLE que recebe a altitude, em metros. Pode ser NULL.

Retornar valor

Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor retornado Descrição
S_OK
O método foi retornado com êxito.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
O relatório de localização não inclui dados para o campo solicitado. Esse resultado é retornado quando o sensor de localização não dá suporte à altitude.

Comentários

O método GetAltitude recupera a altitude em relação ao elipsoide de referência definido pela última revisão do Sistema Geodésico Mundial (WGS 84), em vez da altitude em relação ao nível do mar.

Exemplos

O exemplo de código a seguir demonstra como chamar GetAltitude. Altitude é um campo opcional em relatórios de latitude/longitude, portanto, GetAltitude nem sempre pode retornar dados.

DOUBLE altitude = 0;
// Print the Altitude
if (SUCCEEDED(spLatLongReport->GetAltitude(&altitude)))
{
    wprintf(L"Altitude: %f\n", altitude);
}
else
{
    // Altitude is optional and may not be available
    wprintf(L"Altitude: Not available.\n");
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho], Windows 7
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho locationapi.h
DLL LocationAPI.dll

Confira também

ILatLongReport