Método ILocationEvents::OnStatusChanged (locationapi.h)
[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 . ]
Se llama cuando cambia el estado de un informe.
Sintaxis
HRESULT OnStatusChanged(
[in] REFIID reportType,
[in] LOCATION_REPORT_STATUS newStatus
);
Parámetros
[in] reportType
REFIID que especifica el identificador de interfaz del tipo de informe para el que ha cambiado el estado.
[in] newStatus
Constante de la enumeración LOCATION_REPORT_STATUS que contiene el nuevo estado.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Este evento proporciona el estado del informe para los nuevos informes. Los informes más recientes permanecen disponibles a través de ILocation::GetReport, independientemente del estado notificado por este evento.
Ejemplos
A continuación se muestra una implementación de ejemplo de OnStatusChanged que controla los eventos modificados de estado para los informes de latitud y longitud.
// This is called when the status of a report type changes.
// The LOCATION_REPORT_STATUS enumeration is defined in LocApi.h in the SDK
STDMETHODIMP CLocationEvents::OnStatusChanged(REFIID reportType, LOCATION_REPORT_STATUS status)
{
if (IID_ILatLongReport == reportType)
{
switch (status)
{
case REPORT_NOT_SUPPORTED:
wprintf(L"\nNo devices detected.\n");
break;
case REPORT_ERROR:
wprintf(L"\nReport error.\n");
break;
case REPORT_ACCESS_DENIED:
wprintf(L"\nAccess denied to reports.\n");
break;
case REPORT_INITIALIZING:
wprintf(L"\nReport is initializing.\n");
break;
case REPORT_RUNNING:
wprintf(L"\nRunning.\n");
break;
}
}
else if (IID_ICivicAddressReport == reportType)
{
}
return S_OK;
}
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 |