msiSourceListForceResolutionExA 函式 (msi.h)
MsiSourceListForceResolutionEx函式會移除名為 「LastUsedSource」 的屬性註冊。 此函式不會影響已註冊的來源清單。 每當安裝程式要求來源重新安裝產品或修補程式時，會先嘗試註冊為 「LastUsedSource」 的來源。 如果失敗，或該註冊遺失，安裝程式會搜尋其他已註冊的來源，直到找到有效的來源，或直到來源清單耗盡為止。 清除 「LastUsedSource」 註冊會強制安裝程式在下一次需要來源時針對已註冊的來源執行來源解析。
語法
UINT MsiSourceListForceResolutionExA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions
);
參數
[in] szProductCodeOrPatchCode
產品或修補程式的 ProductCode 或修補程式 GUID。 使用以 Null 結尾的字串。 如果字串超過 39 個字元，則函式會失敗並傳回ERROR_INVALID_PARAMETER。 此參數不可為 Null。
[in, optional] szUserSid
此參數可以是字串 SID，指定包含產品或修補程式的使用者帳戶。 SID 未經過驗證或解析。 不正確的 SID 可以傳回ERROR_UNKNOWN_PRODUCT或ERROR_UNKNOWN_PATCH。 參考電腦內容時， szUserSID 必須是 Null ，且 dwCoNtext 必須MSIINSTALLCONTEXT_MACHINE。 使用電腦 SID (「S-1-5-18」) 會傳回 ERROR_INVALID PARAMETER。 參考目前的使用者帳戶時， szUserSID 可以是 Null ，而 dwCoNtext 可以MSIINSTALLCONTEXT_USERMANAGED或MSIINSTALLCONTEXT_USERUNMANAGED。
[in] dwContext
此參數會指定產品或修補程式實例的內容。 此參數可以包含下列其中一個值。
| 內容類型 | 意義 |
|---|---|
|
產品或修補程式實例存在於每個使用者管理的內容中。 |
|
產品或修補程式實例存在於每位使用者 Unmanaged 內容中。 |
|
產品或修補程式實例存在於每部電腦內容中。 |
[in] dwOptions
dwOptions值決定szProductCodeOrPatchCode值的解譯。
| 旗標 | 意義 |
|---|---|
|
szProductCodeOrPatchCode 是產品名稱。 |
|
szProductCodeOrPatchCode 是修補程式程式碼。 |
傳回值
MsiSourceListForceResolutionEx函式會傳回下列值。
| 值 | 意義 |
|---|---|
|
使用者無法修改指定的來源清單。 不指出找到產品或修補程式。 |
|
組態資料已損毀。 |
|
無法存取 Windows Installer 服務 |
|
不正確參數已傳遞至 函式。 |
|
已清除 「LastUsedSource」 註冊。 |
|
找不到修補程式。 |
|
找不到指定的產品或修補程式。 |
|
非預期的內部失敗。 |
備註
系統管理員可以修改存在於電腦內容底下的產品或修補程式實例安裝，或在自己的個別使用者內容下， (Managed 或 Unmanaged.) 他們可以修改任何使用者個別受管理內容下所存在的產品或修補程式實例安裝。 系統管理員無法修改另一位使用者所安裝的產品或修補程式實例，該實例存在於其他使用者的個別使用者非受控內容之下。
非系統管理員無法修改存在於另一位使用者的個別使用者內容下之產品或修補程式實例的安裝， (Managed 或 Unmanaged.) 他們可以修改在其本身個別使用者非受控內容下之產品或修補程式實例的安裝。 他們只能在啟用產品或修補程式來源流覽產品或修補程式來源時，修改機器內容或自己的個別使用者管理內容安裝。 使用者可以藉由設定原則來流覽來源，如需詳細資訊，請參閱 DisableBrowse、 AllowLockdownBrowse和 AlwaysInstallElevated 原則。
注意
msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiSourceListForceResolutionEx 定義為別名，自動選取此函式的 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 3.0 或更新版本。 如需 Windows Installer 版本所需的最低 Windows Service Pack 相關資訊，請參閱 Windows Installer Run-Time 需求。 |
| 目標平台 | Windows |
| 標頭 | msi.h |
| 程式庫 | Msi.lib |
| Dll | Msi.dll |