Metodo ILatLongReport::GetAltitude (locationapi.h)

Articolo
03/05/2024

[L'API Percorso Win32 è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece l'API Windows.Devices.Geolocation . ]

Recupera l'altitudine, in metri. L'altitudine è relativa ai puntini di sospensione del riferimento.

Sintassi

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Parametri

[out] pAltitude

Indirizzo di un DOUBLE che riceve l'altitudine, in metri. Può essere NULL.

Valore restituito

I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Valore restituito	Descrizione
S_OK	Il metodo è stato restituito correttamente.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Il report sulla posizione non include i dati per il campo richiesto. Questo risultato viene restituito quando il sensore di posizione non supporta l'altitudine.

Commenti

Il metodo GetAltitude recupera l'altitudine relativa ai puntini di sospensione di riferimento definiti dalla revisione più recente del Sistema Geodetico Mondiale (WGS 84), anziché l'altitudine relativa al livello del mare.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare GetAltitude. L'altitudine è un campo facoltativo nei report di latitudine/longitudine, quindi GetAltitude potrebbe non restituire sempre i dati.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop],Windows 7
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	locationapi.h
DLL	LocationAPI.dll

Vedi anche

ILatLongReport

Condividi tramite