共用方式為

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 方法會擷取相對於參考橢圓體的高度，該參考橢圓體是由 World Geodetic System (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