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 TRUE。
如果函式失敗,傳回值就是下表所識別的錯誤碼之一。
傳回碼 | 描述 |
---|---|
|
目前還不清楚該產品。 |
|
無效的自變數會傳遞至 函式。 |
|
產品的組態信息無效。 |
|
函式失敗。 |
|
函式不適用於特定平臺。 |
言論
注意
msi.h 標頭會根據 UNICODE 預處理器常數的定義,將 MsiIsProductElevated 定義為自動選取此函式的 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 需求。 |
目標平臺 | 窗戶 |
標頭 | msi.h |
連結庫 | Msi.lib |
DLL | Msi.dll |
另請參閱
為非系統管理員 安裝具有較高許可權的套件