IDefaultLocation::Metode SetReport (locationapi.h)

Artikel
02/28/2024

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

Mengatur lokasi default.

Sintaks

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

Parameter

[in] reportType

REFIID yang mewakili ID antarmuka dari jenis laporan yang diteruskan menggunakan pLocationReport.

[in] pLocationReport

Arahkan ke instans ILocationReport yang berisi laporan lokasi dari penyedia lokasi default.

Nilai kembali

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

Mengembalikan nilai	Deskripsi
S_OK	Laporan lokasi berhasil disetel.
E_INVALIDARG	Laporan lokasi berisi data yang tidak valid. Ini dapat terjadi ketika laporan alamat satwa tidak berisi kode negara atau wilayah dua huruf IS0 3166 yang valid, atau ketika laporan lintang/bujur tidak berisi garis lintang antara -90 dan 90 atau tidak berisi bujur antara -180 dan 180.
E_ACCESSDENIED	Pengguna tidak memiliki izin untuk mengatur lokasi default.

Keterangan

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

Perhatikan bahwa jenis yang ditentukan oleh reportType harus IID dari ICivicAddressReport atau ILatLongReport.

Garis lintang dan bujur yang disediakan dalam laporan lintang/bujur harus sesuai dengan lokasi di dunia. Jika tidak, metode ini mengembalikan nilai kesalahan HRESULT .

Catatan Aplikasi tidak menerima peristiwa perubahan lokasi yang diharapkan dari OnLocationChanged jika kedua kondisi berikut ini benar. Pertama, aplikasi berjalan sebagai layanan, dalam konteks akun pengguna LOCALSERVICE, SYSTEM, atau NETWORKSERVICE. Kedua, lokasi mengubah hasil peristiwa dari mengubah lokasi default, baik secara manual saat pengguna memilih Lokasi Default di Panel Kontrol, atau secara terprogram saat aplikasi memanggil IDefaultLocation::SetReport.

Contoh

Contoh berikut menunjukkan cara mengatur lokasi default menggunakan laporan alamat syariah.

            // set the civic address fields of the Default Location
            hr = spDefaultLocation->SetReport(IID_ICivicAddressReport, spCivicAddressReport);
            if (E_INVALIDARG == hr)
            {
                wprintf(L"The civic address report has invalid data. ");
                wprintf(L"Country/region must be a valid ISO-3166 2-letter or 3-letter code.\n");
            }
            else if (E_ACCESSDENIED == hr)
            {
                wprintf(L"Administrator privilege required.\n");
            }

Persyaratan

Persyaratan	Nilai
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

IDefaultLocation

Bagikan melalui