Méthode ILocationEvents ::OnLocationChanged (locationapi.h)

[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 . ]

Appelé lorsqu’un nouveau rapport d’emplacement est disponible.

Syntaxe

HRESULT OnLocationChanged(
  [in] REFIID          reportType,
  [in] ILocationReport *pLocationReport
);

Paramètres

[in] reportType

REFIID qui contient l’ID d’interface du type de rapport contenu dans pLocationReport.

[in] pLocationReport

Pointeur vers le instance ILocationReport qui contient le nouveau rapport d’emplacement.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

ILocationReport est l’interface de base de types de rapports d’emplacement spécifiques. L’interface réelle que l’appelant reçoit pour pLocationReport correspond au type spécifié par reportType.

Si l’application appelle OnLocationChanged à la suite de sa première utilisation de l’emplacement, l’appel peut entraîner l’affichage d’une notification dans la barre des tâches et entraîner la connexion d’un événement d’activité d’emplacement observateur d'événements.

Note Une application ne reçoit pas l’événement de changement d’emplacement attendu de OnLocationChanged si les deux conditions suivantes sont remplies. Tout d’abord, l’application s’exécute en tant que service, dans le contexte du compte d’utilisateur LOCALSERVICE, SYSTEM ou NETWORKSERVICE. Deuxièmement, l’événement de changement d’emplacement résulte de la modification de l’emplacement par défaut, soit manuellement lorsque l’utilisateur sélectionne Emplacement par défaut dans Panneau de configuration, soit par programmation lorsqu’une application appelle IDefaultLocation ::SetReport.

 

Exemples

L’exemple d’implémentation suivant d’OnLocationChanged gère l’événement de changement d’emplacement pour un rapport de latitude/longitude. Cette implémentation imprime les informations suivantes sur un événement de changement d’emplacement de latitude/longitude : l’horodatage, l’ID du capteur, la latitude, la longitude, le rayon d’erreur, l’altitude et l’erreur d’altitude.

// This is called when there is a new location report
STDMETHODIMP CLocationEvents::OnLocationChanged(REFIID reportType, ILocationReport* pLocationReport)
{
    // If the report type is a Latitude/Longitude report (as opposed to IID_ICivicAddressReport or another type)
    if (IID_ILatLongReport == reportType)
    {
        CComPtr<ILatLongReport> spLatLongReport;

        // Get the ILatLongReport interface from ILocationReport
        if ((SUCCEEDED(pLocationReport->QueryInterface(IID_PPV_ARGS(&spLatLongReport)))) && (NULL != spLatLongReport.p))
        {
            // Print the Report Type GUID
            wchar_t szGUID[64];
            wprintf(L"\nReportType: %s", GUIDToString(IID_ILatLongReport, szGUID, ARRAYSIZE(szGUID)));

            // Print the Timestamp and the time since the last report
            SYSTEMTIME systemTime;
            if (SUCCEEDED(spLatLongReport->GetTimestamp(&systemTime)))
            {
                // Compute the number of 100ns units that difference between the current report's time and the previous report's time.
                ULONGLONG currentTime = 0, diffTime = 0;
                if (TRUE == SystemTimeToFileTime(&systemTime, (FILETIME*)&currentTime))
                {
                    diffTime = (currentTime > m_previousTime) ? (currentTime - m_previousTime) : 0;
                }

                wprintf(L"\nTimestamp: YY:%d, MM:%d, DD:%d, HH:%d, MM:%d, SS:%d, MS:%d [%I64d]\n",
                    systemTime.wYear,
                    systemTime.wMonth,
                    systemTime.wDay,
                    systemTime.wHour,
                    systemTime.wMinute,
                    systemTime.wSecond,
                    systemTime.wMilliseconds,
                    diffTime / 10000); // Display in milliseconds

                m_previousTime = currentTime; // Set the previous time to the current time for the next report.
            }

            // Print the Sensor ID GUID
            GUID sensorID = {0};
            if (SUCCEEDED(spLatLongReport->GetSensorID(&sensorID)))
            {
                wchar_t szGUID[64];
                wprintf(L"SensorID: %s\n", GUIDToString(sensorID, szGUID, ARRAYSIZE(szGUID)));
            }

            DOUBLE latitude = 0, longitude = 0, altitude = 0, errorRadius = 0, altitudeError = 0;

            // Print the Latitude
            if (SUCCEEDED(spLatLongReport->GetLatitude(&latitude)))
            {
                wprintf(L"Latitude: %f\n", latitude);
            }

            // Print the Longitude
            if (SUCCEEDED(spLatLongReport->GetLongitude(&longitude)))
            {
                wprintf(L"Longitude: %f\n", longitude);
            }

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

            // Print the Error Radius
            if (SUCCEEDED(spLatLongReport->GetErrorRadius(&errorRadius)))
            {
                wprintf(L"Error Radius: %f\n", errorRadius);
            }

            // Print the Altitude Error
            if (SUCCEEDED(spLatLongReport->GetAltitudeError(&altitudeError)))
            {
                wprintf(L"Altitude Error: %f\n", altitudeError);
            }
            else
            {
                // Altitude Error is optional and may not be available
                wprintf(L"Altitude Error: Not available.\n");
            }
        }
    }

    return S_OK;
}

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