MsiIsProductElevatedA 函式 (msi.h)
MsiIsProductElevated 函式會傳回產品是否受管理。 只有需要提高安裝許可權並透過公告安裝的應用程式會被視為受管理,這表示一律會將每部電腦安裝的應用程式視為受管理。
只有在模擬使用者的本機系統程式公告應用程式時,才會將安裝個別使用者的應用程式視為受管理。 如需詳細資訊,請參閱 使用提高的許可權來公告要安裝 Per-User 應用程式。
MsiIsProductElevated 會驗證本機系統是否擁有產品登錄資料。 函式不會參考帳戶原則,例如 AlwaysInstallElevated。
語法
UINT MsiIsProductElevatedA(
[in] LPCSTR szProduct,
[out] BOOL *pfElevated
);
參數
[in] szProduct
產品的完整產品代碼 GUID。
這個參數是必要的,而且不能是 Null 或空白。
[out] pfElevated
結果之 BOOL 的指標。
此參數不可為 Null。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS,如果產品是受控應用程式, 則 pfElevated 會設定為 TRUE 。
如果函式失敗,傳回值就是下表中所識別的錯誤碼之一。
傳回碼 | 描述 |
---|---|
|
目前不知道產品。 |
|
不正確引數會傳遞至 函式。 |
|
產品的組態資訊無效。 |
|
函式失敗。 |
|
函式不適用於特定平臺。 |
備註
注意
msi.h 標頭會將 MsiIsProductElevated 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
最低支援的用戶端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer。 如需 Windows Installer 版本所需的最低 Windows Service Pack 相關資訊,請參閱 Windows Installer Run-Time 需求。 |
目標平台 | Windows |
標頭 | msi.h |
程式庫 | Msi.lib |
Dll | Msi.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應