IDefaultLocation::Metode GetReport (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 jenis laporan yang ditentukan dari penyedia lokasi default.

Sintaks

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

Parameter

[in] reportType

REFIID mewakili ID antarmuka untuk jenis laporan yang diambil.

[out] ppLocationReport

Alamat penunjuk ke ILocationReport yang menerima laporan lokasi yang ditentukan dari penyedia lokasi default.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Laporan lokasi berhasil diambil.
E_INVALIDARG	reportType selain IID_ILatLongReport atau IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Tidak ada data yang tersedia. Ini mungkin karena kurangnya data lokasi default di registri, data yang rusak di registri, atau bidang Negara/Wilayah yang hilang dalam laporan lokasi default.
E_POINTER	ppLocationReport adalah NULL.

Keterangan

ILocationReport adalah antarmuka dasar untuk jenis laporan lokasi tertentu. Antarmuka aktual yang Anda gunakan untuk ppLocationReport harus cocok dengan jenis yang Anda tentukan melalui reportType.

Panggilan ke IDefaultLocation::GetReport dapat mengakibatkan pemberitahuan ditampilkan di taskbar, dan peristiwa Aktivitas Lokasi dicatat di Pemonitor Peristiwa, jika itu adalah penggunaan lokasi pertama aplikasi.

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

Tentang Pemberitahuan Lokasi

Tentang Aktivitas Lokasi Pengelogan

IDefaultLocation