Compartir a través de

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

  • Artículo

[La API de ubicación de Win32 está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la API Windows.Devices.Geolocation . ]

Recupera la altitud, en metros. La altitud es relativa al elipsoide de referencia.

Sintaxis

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

Parámetros

[out] pAltitude

Dirección de un DOUBLE que recibe la altitud, en metros. Puede ser NULL.

Valor devuelto

Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Valor devuelto Descripción
S_OK
 El método se devolvió correctamente.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
 El informe de ubicación no incluye datos para el campo solicitado. Este resultado se devuelve cuando el sensor de ubicación no admite la altitud.

Comentarios

El método GetAltitude recupera la altitud relativa al elipsoide de referencia definido por la última revisión del Sistema Geodético Mundial (WGS 84), en lugar de la altitud relativa al nivel del mar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a GetAltitude. La altitud es un campo opcional en los informes de latitud y longitud, por lo que GetAltitude no siempre puede devolver datos.

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio],Windows 7
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado locationapi.h
Archivo DLL LocationAPI.dll

Consulte también

ILatLongReport