ILocation::Metode GetReportInterval (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 . ]

Mengambil jumlah waktu yang diminta, dalam milidetik, di antara peristiwa laporan.

Sintaks

HRESULT GetReportInterval(
  [in]  REFIID reportType,
  [out] DWORD  *pMilliseconds
);

Parameter

[in] reportType

REFIID yang menentukan jenis laporan untuk mendapatkan interval.

[out] pMilliseconds

Alamat DWORD yang menerima nilai interval laporan, dalam milidetik. Jika laporan tidak terdaftar, ini akan diatur ke NULL. Jika nilai ini diatur ke nol, tidak ada interval minimum yang ditentukan dan aplikasi Anda menerima peristiwa pada interval default sensor lokasi.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	reportType selain IID_ILatLongReport atau IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Pemanggil tidak terdaftar untuk menerima peristiwa untuk jenis laporan yang ditentukan.
E_INVALIDARG	pMilliseconds adalah NULL.

Keterangan

Anda harus memanggil RegisterForReport sebelum memanggil metode ini.

Contoh

Contoh berikut menunjukkan cara memanggil GetReportInterval.

DWORD reportInterval = 0;
HRESULT hr = spLocation->GetReportInterval(IID_ILatLongReport, &reportInterval);

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

ILokasi