ILatLongReport：：GetAltitude 方法 (locationapi.h)

  • 项目

[Win32 位置 API 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows.Devices.Geolocation API。 ]

检索海拔高度（以米为单位）。 海拔高度相对于参考椭圆体。

语法

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
标头 locationapi.h
DLL LocationAPI.dll

另请参阅

ILatLongReport