MsiSourceListAddSourceExA 函式 (msi.h)

MsiSourceListAddSourceEx函式會在指定的內容中新增或重新排列修補程式或產品的來源集合。 它也可以為不存在於指定內容中的修補程式建立來源清單。

語法

UINT MsiSourceListAddSourceExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           LPCSTR            szSource,
  [in, optional] DWORD             dwIndex
);

參數

[in] szProductCodeOrPatchCode

產品或修補程式的 ProductCode 或修補程式 GUID。 使用以 Null 結尾的字串。 如果字串超過 39 個字元,函式會失敗並傳回 ERROR_INVALID_PARAMETER。 此參數不可為 Null

[in, optional] szUserSid

此參數可以是字串 SID,指定包含產品或修補程式的使用者帳戶。 SID 未經過驗證或解析。 不正確的 SID 可能會傳回 ERROR_UNKNOWN_PRODUCTERROR_UNKNOWN_PATCH。 參考電腦內容時, szUserSID 必須是 Null而且 dwCoNtext 必須 MSIINSTALLCONTEXT_MACHINE

SID 的類型 意義
NULL
Null 表示目前登入的使用者。 參考目前的使用者帳戶時, szUserSID 可以是 Null而 dwCoNtext 可以 MSIINSTALLCONTEXT_USERMANAGEDMSIINSTALLCONTEXT_USERUNMANAGED
使用者 SID
指定系統中特定使用者的列舉。 使用者 SID 的範例為 「S-1-3-64-2415071341-1358098788-3127455600-2561」。
 
注意 特殊 SID 字串 s-1-5-18 (系統) 無法用來列舉依每部電腦安裝的產品或修補程式。 將 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值的解譯,以及要清除的來源類型。 此參數必須是下列其中一個MSISOURCETYPE_ 常數和下列 其中一個MSICODE_ 常數的組合。

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

[in] szSource

要新增或移動的來源。 此參數應該只包含不含檔案名的路徑。 檔案名已經註冊為 「PackageName」,而且可以透過 MsiSourceListSetInfo操作。 此引數為必要項目。

[in, optional] dwIndex

此參數會提供來源的新索引。 所有來源都會在來源清單中編制索引,從 1 到 N,其中 N 是清單中的來源計數。 清單中的每個來源都有唯一的索引。

如果使用新的來源呼叫 MsiSourceListAddSourceEx並將 dwIndex 設定為 0 (零) ,則新來源會附加至現有的清單。 如果 dwIndex 設定為 0,而且來源已存在於清單中,就不會在清單中完成任何更新。

如果使用新的來源呼叫 MsiSourceListAddSourceEx並將 dwIndex 設定為小於 count 的非零值, (N) ,則新來源會放在指定的索引,而其他來源則會重新編制索引。 如果來源已經存在,則會移至指定的索引,並重新編制其他來源的索引。

如果使用新的來源呼叫 MsiSourceListAddSourceEx並將 dwIndex 設定為大於來源計數的非零值, (N) ,則會將新的來源附加至現有的清單。 如果來源已經存在,則會移至清單結尾,並重新編制其他來源的索引。

傳回值

MsiSourceListAddSourceEx函式會傳回下列值。

意義
ERROR_ACCESS_DENIED
使用者無法新增或移動來源。 不會指出找到產品或修補程式。
ERROR_BAD_CONFIGURATION
設定資料已損毀。
ERROR_INSTALL_SERVICE_FAILURE
無法存取 Windows Installer 服務。
ERROR_SUCCESS
已插入或更新來源。
ERROR_UNKNOWN_PRODUCT
指定的產品未知。
ERROR_UNKNOWN_PATCH
指定的修補程式未知。
ERROR_FUNCTION_FAILED
非預期的內部失敗。

備註

系統管理員可以修改存在於電腦內容底下之產品或修補程式實例的安裝,或在自己的個別使用者內容下, (Managed 或 Unmanaged.) 他們可以修改任何使用者個別受管理內容下所存在的產品或修補程式實例安裝。 系統管理員無法修改另一位使用者所安裝的產品或修補程式實例,該實例存在於該其他使用者的個別使用者非受控內容之下。

非系統管理員無法修改存在於另一位使用者個別使用者內容之下的產品或修補程式實例安裝, (Managed 或 Unmanaged。) 他們可以修改其本身個別使用者-Unmanaged 內容下所存在的產品或修補程式實例安裝。 他們只能在啟用產品或修補程式來源流覽產品或修補程式來源時,修改機器內容下或自己的個別使用者管理內容安裝。 您可以藉由設定原則來啟用使用者來流覽來源。 如需詳細資訊,請參閱 DisableBrowseAllowLockdownBrowseAlwaysInstallElevated 原則

注意

msi.h 標頭會將 MsiSourceListAddSourceEx 定義為別名,根據 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

另請參閱

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

MsiSourceListSetInfo

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

ProductCode

來源復原