MsiSourceListGetInfoA 函式 （msi.h）
MsiSourceListGetInfo 函式會擷取特定內容中產品或修補程式的來源清單相關信息。
語法
UINT MsiSourceListGetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[out, optional] LPSTR szValue,
[in, out, optional] LPDWORD pcchValue
);
參數
[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
| 旗 | 意義 |
|---|---|
|
szProductCodeOrPatchCode 是產品名稱 GUID。 |
|
szProductCodeOrPatchCode 是修補程式程式代碼 GUID。 |
[in] szProperty
以 Null 結束的字串，指定要擷取的屬性值。 szProperty 參數可以是下列其中一個值。
[out, optional] szValue
接收信息的輸出緩衝區。 這個緩衝區應該夠大，足以包含資訊。 如果緩衝區太小，函式會傳回ERROR_MORE_DATA，並將 *pcchValue 設定為值中 TCHAR 的數目，不包括終止的 NULL 字元。
如果
如果 szValue 和 pcchValue 都設定為 NULL，則函式會傳回ERROR_SUCCESS值，而不擷取值。
[in, out, optional] pcchValue
變數的指標，指定 szValue 緩衝區中 TCHAR 的數目。 當函式傳回時，此參數會設定為要求值的大小，不論函式是否會將值複製到指定的緩衝區。 大小會以要求值中的 TCHAR 數目傳回，不包括終止的 Null 字元。
只有當 szValue 也 NULL時，這個參數才能設定為 NULL，否則函式會傳回ERROR_INVALID_PARAMETER。
傳回值
MsiSourceListGetInfo 函式會傳回下列值。
| 價值 | 意義 |
|---|---|
|
使用者無法讀取指定的來源清單。 這不會指出找到產品或修補程式。 |
|
組態數據已損毀。 |
|
無效的參數會傳遞至函式。 |
|
提供的緩衝區不足以包含要求的數據。 |
|
已成功擷取 屬性。 |
|
找不到修補程式。 |
|
找不到產品。 |
|
找不到來源屬性。 |
|
非預期的內部失敗。 |
言論
系統管理員可以修改存在於計算機內容下或個別用戶內容下的產品或修補程序實例安裝（Managed 或 Unmanaged）。他們可以修改存在於任何使用者個別受管理內容下的產品或修補程序實例安裝。 系統管理員無法修改另一位使用者安裝存在於該其他使用者的個別使用者非受控內容下的產品或修補程序實例。
非系統管理員無法修改存在於其他使用者個別內容下的產品或修補程序實例安裝（Managed 或 Unmanaged）。他們可以修改存在於其個別使用者非受控內容下的產品或修補程序實例安裝。 他們只能在啟用瀏覽產品或修補程式來源時，修改機器內容下的產品或修補程式實例安裝，或修改自己的個別使用者管理內容。 您可以藉由設定原則來啟用使用者來瀏覽來源。 如需詳細資訊，請參閱 DisableBrowse、AllowLockdownBrowse和 AlwaysInstallElevated 原則。
注意
msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiSourceListGetInfo 定義為自動選取此函式的 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 需求。 |
| 目標平臺 | 窗戶 |
| 標頭 | msi.h |
| 連結庫 | Msi.lib |
| DLL | Msi.dll |