Fungsi MsiIsProductElevatedA (msi.h)

Artikel
11/20/2024

Fungsi MsiIsProductElevated mengembalikan apakah produk dikelola atau tidak. Hanya aplikasi yang memerlukan hak istimewa yang ditingkatkan untuk penginstalan dan diinstal melalui iklan yang dianggap terkelola, yang berarti bahwa aplikasi yang diinstal per mesin selalu dianggap terkelola.

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 yang akan Diinstal dengan Hak Istimewa yang Ditingkatkan.

MsiIsProductElevated memverifikasi bahwa sistem lokal memiliki data registri produk. Fungsi ini tidak merujuk ke kebijakan akun seperti AlwaysInstallElevated.

Sintaksis

UINT MsiIsProductElevatedA(
  [in]  LPCSTR szProduct,
  [out] BOOL   *pfElevated
);

Parameter

[in] szProduct

GUID kode produk lengkap produk.

Parameter ini diperlukan dan tidak dapat null atau kosong.

[out] pfElevated

Penunjuk ke BOOL untuk hasilnya.

Parameter ini tidak dapat null.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian ERROR_SUCCESS, dan pfElevated diatur ke TRUE jika produk adalah aplikasi terkelola.

Jika fungsi gagal, nilai pengembalian adalah salah satu kode kesalahan yang diidentifikasi dalam tabel berikut.

Mengembalikan kode	Deskripsi
ERROR_UNKNOWN_PRODUCT	Produk saat ini tidak diketahui.
ERROR_INVALID_PARAMETER	Argumen yang tidak valid diteruskan ke fungsi.
ERROR_BAD_CONFIGURATION	Informasi konfigurasi untuk produk tidak valid.
ERROR_FUNCTION_FAILED	Fungsi gagal.
ERROR_CALL_NOT_IMPLEMENTED	Fungsi ini tidak tersedia untuk platform tertentu.

Komentar

Nota

Header msi.h mendefinisikan MsiIsProductElevated sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
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 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	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

Bagikan melalui