Fungsi MsiIsProductElevatedA (msi.h)
Fungsi MsiIsProductElevated mengembalikan apakah produk dikelola atau tidak. Hanya aplikasi yang memerlukan hak istimewa yang ditingkatkan untuk penginstalan dan diinstal melalui iklan yang dianggap dikelola, yang berarti bahwa aplikasi yang diinstal per mesin selalu dianggap dikelola.
Aplikasi yang diinstal per pengguna hanya dianggap dikelola jika diiklankan oleh proses sistem lokal yang meniru pengguna. Untuk informasi selengkapnya, lihat Mengiklankan Aplikasi Per-User untuk Diinstal dengan Hak Istimewa yang Ditingkatkan.
MsiIsProductElevated memverifikasi bahwa sistem lokal memiliki data registri produk. Fungsi ini tidak merujuk ke kebijakan akun seperti AlwaysInstallElevated.
Sintaks
UINT MsiIsProductElevatedA(
[in] LPCSTR szProduct,
[out] BOOL *pfElevated
);
Parameter
[in] szProduct
GUID kode produk lengkap produk.
Parameter ini diperlukan dan tidak boleh NULL atau kosong.
[out] pfElevated
Penunjuk ke BOOL untuk hasilnya.
Parameter ini tidak boleh NULL.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS, dan pfElevated diatur ke TRUE jika produk adalah aplikasi terkelola.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan yang diidentifikasi dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Produk saat ini tidak diketahui. |
|
Argumen yang tidak valid diteruskan ke fungsi. |
|
Informasi konfigurasi untuk produk tidak valid. |
|
Fungsi gagal. |
|
Fungsi ini tidak tersedia untuk platform tertentu. |
Keterangan
Catatan
Header msi.h mendefinisikan MsiIsProductElevated sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Klien minimum yang didukung | Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Pemasang Windows pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows. |
Target Platform | Windows |
Header | msi.h |
Pustaka | Msi.lib |
DLL | Msi.dll |
Lihat juga
Menentukan Konteks Penginstalan
Menginstal Paket dengan Hak Istimewa yang Ditingkatkan untuk Non-Admin
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk