Méthode ILatLongReport ::GetAltitude (locationapi.h)

Article
02/28/2024

[L’API d’emplacement Win32 est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt l’API Windows.Devices.Geolocation . ]

Récupère l’altitude, en mètres. L’altitude est relative à l’ellipsoïde de référence.

Syntaxe

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Paramètres

[out] pAltitude

Adresse d’un DOUBLE qui reçoit l’altitude, en mètres. Peut être NULL.

Valeur retournée

Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur retournée	Description
S_OK	Retour réussi de la méthode.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Le rapport d’emplacement n’inclut pas de données pour le champ demandé. Ce résultat est retourné lorsque le capteur d’emplacement ne prend pas en charge l’altitude.

Remarques

La méthode GetAltitude récupère l’altitude par rapport à l’ellipsoïde de référence définie par la dernière révision du Système géodésique mondial (WGS 84), plutôt que l’altitude par rapport au niveau de la mer.

Exemples

L’exemple de code suivant montre comment appeler GetAltitude. Altitude étant un champ facultatif dans les rapports de latitude/longitude, GetAltitude peut ne pas toujours retourner des données.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement],Windows 7
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	locationapi.h
DLL	LocationAPI.dll

Voir aussi

ILatLongReport

Partager via