共用方式為

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。

SID 的類型 意義
NULL
 NULL 表示目前登入的使用者。 參考目前的使用者帳戶時，szUserSID 可以是 NULL，dwContext 可以是 MSIINSTALLCONTEXT_USERMANAGED 或 MSIINSTALLCONTEXT_USERUNMANAGED。
使用者 SID
 指定系統中特定用戶的列舉。 使用者 SID 的範例是 “S-1-3-64-2415071341-1358098788-3127455600-2561”。
 
附註 特殊 SID 字串 “S-1-5-18” （system） 無法用來列舉依機器安裝的產品或修補程式。 將 SID 值設定為 「S-1-5-18」 會傳回 「ERROR_INVALID_PARAMETER」。
 
附註 不應使用特殊的 SID 字串 “S-1-1-0” （所有人）。 將 SID 值設定為 「S-1-1-0」 會失敗，並傳回 ERROR_INVALID_PARAM。
 

[in] dwContext

此參數會指定產品或修補程序實例的內容。 此參數可以包含下列其中一個值。

內容類型 意義
MSIINSTALLCONTEXT_USERMANAGED
 產品或修補程序實例存在於每個使用者管理的內容中。
MSIINSTALLCONTEXT_USERUNMANAGED
 產品或修補程序實例存在於個別使用者 Unmanaged 內容中。
MSIINSTALLCONTEXT_MACHINE
 產品或修補程序實例存在於每部計算機內容中。

[in] dwOptions

dwOptions 值會指定 szProductCodeOrPatchCode的意義。

如果設定的屬性是 「LastUsedSource」，此參數也會將來源的類型指定為網路或 URL。 在此情況下，dwOptions 參數必須是下列其中一個 MSISOURCETYPE_ 常數和下列其中一個 MSICODE_ 常數的組合。

旗 意義
MSISOURCETYPE_NETWORK
 來源是網路類型。
MSISOURCETYPE_URL
 來源是 URL 類型。
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是產品名稱 GUID。
MSICODE_PATCH
 szProductCodeOrPatchCode 是修補程式程式代碼 GUID。

[in] szProperty

參數 szProperty 表示要設定的屬性值。 並非所有可透過 msiSourceListGetInfo 擷取的屬性， 都可以透過呼叫 MsiSourceListSetInfo來設定。 szProperty 值可以是下列其中一個值。

名字 意義
INSTALLPROPERTY_MEDIAPACKAGEPATH
“MediaPackagePath”
 相對於安裝媒體根目錄的路徑。
INSTALLPROPERTY_DISKPROMPT
“DiskPrompt”
 提示使用者輸入安裝媒體時所使用的提示範本。
INSTALLPROPERTY_LASTUSEDSOURCE
“LastUsedSource”
 產品最近使用的來源位置。 如果未註冊來源，函式會呼叫 MsiSourceListAddSourceEx 來註冊它。 成功註冊時，函式會將來源設定為 LastUsedSource。
INSTALLPROPERTY_PACKAGENAME
“PackageName”
 來源上的 Windows Installer 套件或修補程式套件名稱。

[in] szValue

屬性的新值。 不會執行新值的驗證。 這個值不能 NULL。 它可以是空字串。

傳回值

MsiSourceListSetInfo 函式會傳回下列值。

價值 意義
ERROR_ACCESS_DENIED
 用戶無法設定指定產品的來源清單。
ERROR_BAD_CONFIGURATION
 組態數據已損毀。
ERROR_INSTALL_SERVICE_FAILURE
 無法存取 Windows Installer 服務。
ERROR_INVALID_PARAMETER
 無效的參數已傳遞至函式。
ERROR_SUCCESS
 已設定屬性。
ERROR_UNKNOWN_PATCH
 找不到修補程式。
ERROR_UNKNOWN_PRODUCT
 找不到產品。
ERROR_UNKNOWN_PROPERTY
 找不到來源屬性。
ERROR_FUNCTION_FAILED
 非預期的內部失敗。

言論

系統管理員可以修改存在於計算機內容下或個別用戶內容下的產品或修補程序實例安裝（Managed 或 Unmanaged）。他們可以修改存在於任何使用者個別受管理內容下的產品或修補程序實例安裝。 系統管理員無法修改另一位使用者安裝存在於該其他使用者的個別使用者非受控內容下的產品或修補程序實例。

非系統管理員無法修改存在於其他使用者個別內容下的產品或修補程序實例安裝（Managed 或 Unmanaged）。他們可以修改存在於其個別使用者非受控內容下的產品或修補程序實例安裝。 他們只能在啟用瀏覽產品或修補程式來源時，修改機器內容下的產品或修補程式實例安裝，或修改自己的個別使用者管理內容。 您可以藉由設定原則來啟用使用者來瀏覽來源。 如需詳細資訊，請參閱 DisableBrowse、AllowLockdownBrowse和 AlwaysInstallElevated 原則。

上述規則的例外狀況是將 「LastUsedSource」 設定為其中一個已註冊的來源。 如果來源已註冊，則不論原則為何，非系統管理員都可以將 “LastUsedSource” 設定為自己的安裝（受管理或非受控）和每部計算機安裝。

注意

msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiSourceListSetInfo 定義為自動選取此函式的 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 需求。
目標平臺 窗戶
標頭 msi.h
連結庫 Msi.lib
DLL Msi.dll

另請參閱

安裝內容

MsiSourceListGetInfo

Windows Installer 2.0 和更早版本中不支援

ProductCode