msiSourceListSetInfoA 函式 (msi.h)
MsiSourceListSetInfo 函式會設定特定內容中產品或修補程式來源清單的相關信息。
語法
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
參數
[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。
[in] dwContext
此參數會指定產品或修補程序實例的內容。 此參數可以包含下列其中一個值。
| 內容類型 | 意義 |
|---|---|
|
產品或修補程序實例存在於每個使用者管理的內容中。 |
|
產品或修補程序實例存在於個別使用者 Unmanaged 內容中。 |
|
產品或修補程序實例存在於每部計算機內容中。 |
[in] dwOptions
dwOptions 值會指定 szProductCodeOrPatchCode 的意義。
如果要設定的屬性是 「LastUsedSource」，此參數也會將來源類型指定為網路或 URL。 在此情況下，dwOptions 參數必須是下列其中一個MSISOURCETYPE_常數和下列其中一個MSICODE_常數的組合。
| 旗標 | 意義 |
|---|---|
|
來源是網路類型。 |
|
來源是 URL 類型。 |
|
szProductCodeOrPatchCode 是產品代碼 GUID。 |
|
szProductCodeOrPatchCode 是修補程式碼 GUID。 |
[in] szProperty
參數 szProperty 表示要設定的屬性值。 並非所有可透過 MsiSourceListGetInfo 擷取的屬性都可以透過呼叫 MsiSourceListSetInfo 來設定。 szProperty 值可以是下列其中一個值。
| 名稱 | 意義 |
|---|---|
|
相對於安裝媒體根目錄的路徑。 |
|
提示使用者輸入安裝媒體時所使用的提示範本。 |
|
產品最近使用的來源位置。 如果未註冊來源，函式會呼叫 MsiSourceListAddSourceEx 來註冊它。 成功註冊時，函式會將來源設定為 LastUsedSource。 |
|
來源上 Windows Installer 套件或修補程式套件的名稱。 |
[in] szValue
屬性的新值。 不會執行新值的驗證。 這個值不可以是 NULL。 它可以是空字串。
傳回值
MsiSourceListSetInfo 函式會傳回下列值。
| 值 | 意義 |
|---|---|
|
用戶無法設定指定產品的來源清單。 |
|
設定數據已損毀。 |
|
無法存取 Windows Installer 服務。 |
|
無效的參數已傳遞至 函式。 |
|
已設定屬性。 |
|
找不到修補程式。 |
|
找不到產品。 |
|
找不到來源屬性。 |
|
非預期的內部失敗。 |
備註
系統管理員可以修改存在於計算機內容底下之產品或修補程序實例的安裝，或在自己的個別用戶內容下， (Managed 或 Unmanaged.) 他們可以修改任何使用者個別受管理內容下所存在的產品或修補程式實例安裝。 系統管理員無法修改另一位使用者所安裝的產品或修補程序實例，該實例存在於該其他使用者的個別使用者非受控內容之下。
非系統管理員無法修改存在於另一位使用者個別用戶內容之下的產品或修補程式實例安裝， (Managed 或 Unmanaged。) 他們可以修改其本身個別使用者-Unmanaged 內容下所存在的產品或修補程式實例安裝。 他們只能在啟用產品或修補程式來源瀏覽產品或修補程式來源時，修改機器內容下或自己的個別使用者管理內容安裝。 您可以藉由設定原則來啟用使用者來瀏覽來源。 如需詳細資訊，請參閱 DisableBrowse、 AllowLockdownBrowse 和 AlwaysInstallElevated 原則 。
上述規則的例外狀況是將 「LastUsedSource」 設定為其中一個已註冊的來源。 如果來源已註冊，則不論原則為何，非系統管理員都可以將 “LastUsedSource” 設定為自己的安裝 (受管理或非受控) 和每部計算機安裝。
注意
msi.h 標頭會將 MsiSourceListSetInfo 定義為別名，根據 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 Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。 |
| 目標平台 | Windows |
| 標頭 | msi.h |
| 程式庫 | Msi.lib |
| Dll | Msi.dll |