ILatLongReport::GetAltitude method (locationapi.h)

[The Win32 Location API is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the Windows.Devices.Geolocation API. ]

Retrieves the altitude, in meters. Altitude is relative to the reference ellipsoid.

Syntax

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Parameters

[out] pAltitude

Address of a DOUBLE that receives the altitude, in meters. May be NULL.

Return value

Possible values include, but are not limited to, those in the following table.

Remarks

The GetAltitude method retrieves the altitude relative to the reference ellipsoid that is defined by the latest revision of the World Geodetic System (WGS 84), rather than the altitude relative to sea level.

Examples

The following code example demonstrates how to call GetAltitude. Altitude is an optional field in latitude/longitude reports, so GetAltitude may not always return data.

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

Requirements

See also

ILatLongReport