Metode ILocationEvents::OnStatusChanged (locationapi.h)

[API Lokasi Win32 tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan API Windows.Devices.Geolocation . ]

Dipanggil saat status laporan berubah.

Sintaks

HRESULT OnStatusChanged(
  [in] REFIID                 reportType,
  [in] LOCATION_REPORT_STATUS newStatus
);

Parameter

[in] reportType

REFIID yang menentukan ID antarmuka jenis laporan yang statusnya telah berubah.

[in] newStatus

Konstanta dari enumerasi LOCATION_REPORT_STATUS yang berisi status baru.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Kejadian ini menyediakan status laporan untuk laporan baru. Laporan terbaru tetap tersedia melalui ILocation::GetReport, terlepas dari status yang dilaporkan oleh peristiwa ini.

Contoh

Berikut ini adalah contoh implementasi OnStatusChanged yang menangani peristiwa perubahan status untuk laporan lintang/bujur.

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

Persyaratan

Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop],Windows 7
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	locationapi.h
DLL	LocationAPI.dll

Lihat juga

ILocationEvents