ILatLongReport::GetAltitude-Methode (locationapi.h)
[Die Win32-Standort-API ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows.Devices.Geolocation-API . ]
Ruft die Höhe in Metern ab. Die Höhe ist relativ zum Referenzellipsoid.
Syntax
HRESULT GetAltitude(
[out] DOUBLE *pAltitude
);
Parameter
[out] pAltitude
Adresse eines DOUBLE-Werts , der die Höhe in Metern empfängt. Kann NULL sein.
Rückgabewert
Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabewert | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich zurückgegeben. |
|
Der Standortbericht enthält keine Daten für das angeforderte Feld. Dieses Ergebnis wird zurückgegeben, wenn der Positionssensor die Höhe nicht unterstützt. |
Hinweise
Die GetAltitude-Methode ruft die Höhe relativ zum Referenzellipsoid ab, das durch die neueste Revision des Geodätischen Weltsystems (WGS 84) definiert ist, anstatt die Höhe relativ zum Meeresspiegel.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie GetAltitude aufgerufen wird. Die Höhe ist ein optionales Feld in Breiten-/Längengradberichten, sodass GetAltitude möglicherweise nicht immer Daten zurückgibt.
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");
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps],Windows 7 |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | locationapi.h |
| DLL | LocationAPI.dll |