msiSourceListClearAllExA 函式 (msi.h)

  • 發行項

MsiSourceListClearAllEx 函式會移除指定產品或修補程序實例之指定來源類型的所有現有來源。 如果移除修補程式的唯一來源，而且修補程式未安裝為相同內容中的任何用戶端的新修補程式，也會移除修補程序註冊。 指定 MsiSourceListClearAllEx 移除此產品目前的來源或修補程式會強制安裝程式在下一次需要來源時搜尋來源清單。

語法

UINT MsiSourceListClearAllExA(
  [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

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

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

[in] dwOptions

dwOptions 值會決定 szProductCodeOrPatchCode 值的解譯，以及要清除的來源類型。 此參數必須是下列其中一個MSISOURCETYPE_* 常數和下列其中一個MSICODE_* 常數的組合。

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

傳回值

值 意義
ERROR_ACCESS_DENIED
 用戶無法新增或移動來源。 不會指出找到產品或修補程式。
ERROR_BAD_CONFIGURATION
 設定數據已損毀。
ERROR_INSTALL_SERVICE_FAILURE
 無法存取 Windows Installer 服務。
ERROR_INVALID_PARAMETER
 無效的參數已傳遞至 函式。
ERROR_SUCCESS
 已移除指定型別的所有來源。
ERROR_UNKNOWN_PRODUCT
 指定的產品未知。
ERROR_UNKNOWN_PATCH
 指定的修補程式未知。
ERROR_FUNCTION_FAILED
 非預期的內部失敗。

備註

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

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

注意

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

另請參閱

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

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

ProductCode