MsiSourceListClearMediaDisk 功能提供在特定情境下移除產品或補丁媒體來源下已註冊的磁碟的功能。
語法
UINT MsiSourceListClearMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId
);
參數
[in] szProductCodeOrPatchCode
產品或補丁的 ProductCode 或補丁 GUID。 使用空終端字串。 若字串超過 39 個字元，函式失敗並回傳 ERROR_INVALID_PARAMETER。 這個參數不能 NULL。
[in, optional] szUserSid
這個參數可以是字串 SID，用來指定包含產品或補丁的使用者帳號。 SID 尚未被驗證或解決。 錯誤的 SID 可能會回傳 ERROR_UNKNOWN_PRODUCT 或 ERROR_UNKNOWN_PATCH。
便條 特殊 SID 字串 s-1-5-18（系統）無法用來列舉每台機器安裝的產品或補丁。 將 SID 值設為 s-1-5-18 則返回ERROR_INVALID_PARAMETER。 當 dwContext 僅設為 MSIINSTALLCONTEXT_MACHINE 時，szUserSid 必須是 NULL。
便條 特殊 SID 字串 s-1-1-0（所有人）不應使用。 將 SID 值設為 s-1-1-0 失敗，回傳 ERROR_INVALID_PARAM。
[in] dwContext
此參數指定產品或補丁實例的上下文。 此參數可包含以下其中一個值。
| 語境類型 | Meaning |
|---|---|
|
產品或修補實例存在於每位使用者管理的情境中。 |
|
產品或修補實例存在於每個使用者未管理的上下文中。 |
|
產品或補丁實例存在於每台機器的情境中。 |
[in] dwOptions
dwOptions 值指定了 szProductCodeOrPatchCode 的意義。
| Flag | Meaning |
|---|---|
|
szProductCodeOrPatchCode 是一個產品代碼 GUID。 |
|
szProductCodeOrPatchCode 是一個修補碼 GUID。 |
[in] dwDiskId
此參數提供被移除磁碟的 ID。
返回值
MsiSourceListClearMediaDisk 函式回傳以下值。
| 價值觀 | Meaning |
|---|---|
|
使用者無法讀取指定的媒體來源或指定產品或修補程式。 這並不代表是否找到了媒體來源、產品或補丁。 |
|
設定資料損壞了。 |
|
無法存取 Windows 安裝程式服務。 |
|
無效的參數已傳遞至函式。 |
|
該數值已被成功移除或未被找到。 |
|
但沒有找到那個補丁。 |
|
但該產品未被發現。 |
|
意外的內部故障。 |
備註
管理員可以修改存在於機器情境下的產品或修補實例的安裝，或是在他們自己的每位使用者情境（受管理或非受管理）下。他們可以修改存在於任何使用者每位使用者管理情境下的產品或修補實例的安裝方式。 管理員無法修改其他使用者在該使用者的每個使用者未管理情境下所安裝的產品或修補實例。
非管理員無法修改存在於其他使用者每使用者情境（受管理或非管理）下的產品或修補實例的安裝。他們可以修改存在於其每個使用者未管理上下文下的產品或修補實例的安裝。 只有在啟用瀏覽產品或補丁來源時，他們才能在機器上下文或自身的每用戶管理上下文中修改產品或補丁實例的安裝。 使用者可透過設定政策來瀏覽來源。 欲了解更多資訊，請參閱 DisableBrowse、 AllowLockdownBrowse 及 AlwaysInstallElevated 政策。
備註
msi.h 標頭將 MsiSourceListClearMediaDisk 定義為別名，根據 UNICODE 預處理器常數的定義，自動選擇此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型 的慣例。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | 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 安裝程式 3.0 或更新版本。 請參閱 Windows 安裝程式 Run-Time 需求，了解 Windows 安裝程式版本所需的最低 Windows 服務包。 |
| 目標平臺 | 窗戶 |
| Header | MSI.H |
| Library | Msi.lib |
| DLL | Msi.dll |