Метод ILatLongReport::GetAltitude (locationapi.h)

Статья
08/24/2023

[API расположения Win32 доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте API Windows.Devices.Geolocation . ]

Извлекает высоту в метрах. Высота относительно ссылочного эллипсоида.

Синтаксис

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Параметры

[out] pAltitude

Адрес объекта DOUBLE , который получает высоту в метрах. Может иметь значение NULL.

Возвращаемое значение

Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Возвращаемое значение	Описание
S_OK	Метод возвратился успешно.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Отчет о расположении не содержит данные для запрошенного поля. Этот результат возвращается, если датчик расположения не поддерживает высоту.

Метод GetAltitude извлекает высоту относительно эталонного эллипсоида, определенного последней редакцией Всемирной геодезической системы (WGS 84), а не высоту относительно уровня моря.

Примеры

В следующем примере кода показано, как вызвать GetAltitude. Высота является необязательным полем в отчетах о широте и долготе, поэтому GetAltitude не всегда может возвращать данные.

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");
}

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения],Windows 7
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	locationapi.h
DLL	LocationAPI.dll

См. также раздел

ILatLongReport

Поделиться через