Compartir a través de

Método IDefaultLocation::GetReport (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 el tipo de informe especificado del proveedor de ubicación predeterminado.

Sintaxis

HRESULT GetReport(
  [in]  REFIID          reportType,
  [out] ILocationReport **ppLocationReport
);

Parámetros

[in] reportType

REFIID que representa el identificador de interfaz para el tipo de informe que se va a recuperar.

[out] ppLocationReport

Dirección de un puntero a ILocationReport que recibe el informe de ubicación especificado del proveedor de ubicación predeterminado.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El informe de ubicación se recuperó correctamente.
E_INVALIDARG
 reportType es distinto de IID_ILatLongReport o IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
 No hay datos disponibles. Esto puede deberse a la falta de datos de ubicación predeterminados en el Registro, datos dañados en el Registro o a un campo País o región que falta en el informe de ubicación predeterminado.
E_POINTER
 ppLocationReport es NULL.

Comentarios

ILocationReport es la interfaz base para tipos de informe de ubicación específicos. La interfaz real que use para ppLocationReport debe coincidir con el tipo especificado a través de reportType.

Una llamada a IDefaultLocation::GetReport puede dar lugar a una notificación que se muestra en la barra de tareas y un evento actividad de ubicación que se registra en Visor de eventos, si es el primer uso de la ubicación de la aplicación.

Requisitos

   
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

Acerca de las notificaciones de ubicación

Acerca de la actividad de ubicación de registro

IDefaultLocation