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