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。

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 (系統) 無法用來列舉安裝為個別電腦的產品或修補程式。 將 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的意義。

旗標 意義
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是產品名稱 GUID。
MSICODE_PATCH
 szProductCodeOrPatchCode 是修補程式碼 GUID。

[in] szProperty

以 Null 結尾的字串，指定要擷取的屬性值。 szProperty參數可以是下列其中一個值。

名稱 意義
INSTALLPROPERTY_MEDIAPACKAGEPATH
「MediaPackagePath」
 相對於安裝媒體根目錄的路徑。
INSTALLPROPERTY_DISKPROMPT
「DiskPrompt」
 提示使用者輸入安裝媒體時所使用的提示範本。
INSTALLPROPERTY_LASTUSEDSOURCE
「LastUsedSource」
 產品最近使用的來源位置。
INSTALLPROPERTY_LASTUSEDTYPE
「LastUsedType」
 如果上次使用的來源是網路位置，則為 「n」。 如果上次使用的來源是 URL 位置，則為 「u」。 如果上次使用的來源是媒體，則為 「m」。 如果沒有最後使用的來源，則為空字串 (「」) 。
INSTALLPROPERTY_PACKAGENAME
「PackageName」
 來源上的 Windows Installer 套件或修補程式套件名稱。

[out, optional] szValue

接收資訊的輸出緩衝區。 這個緩衝區應該夠大，足以包含資訊。 如果緩衝區太小，則函式會傳回ERROR_MORE_DATA，並將 *pcchValue 設定為值中的 TCHAR 數目，不包括終止的 Null 字元。

如果 szValue 設定為 Null ， 且 pcchValue 設定為有效的指標，則函式會傳回ERROR_SUCCESS，並將 *pcchValue 設定為值中的 TCHAR 數目，不包括終止的 Null 字元。 然後可以再次呼叫 函式以擷取值， 而 szValue 緩衝區夠大，足以包含 *pcchValue + 1 個字元。

如果 szValue 和 pcchValue 都設定為 Null，則函式會傳回ERROR_SUCCESS如果值存在，而不需要擷取值。

[in, out, optional] pcchValue

指定szValue緩衝區中TCHAR數目的變數指標。 當函式傳回時，不論函式是否將值複製到指定的緩衝區，此參數都設定為要求值的大小。 大小會以要求值中的 TCHAR 數目傳回，不包括終止 Null 字元。

只有當szValue也是Null時，此參數才能設定為Null，否則函式會傳回ERROR_INVALID_PARAMETER。

傳回值

MsiSourceListGetInfo函式會傳回下列值。

值 意義
ERROR_ACCESS_DENIED
 使用者無法讀取指定的來源清單。 這不會指出找到產品或修補程式。
ERROR_BAD_CONFIGURATION
 組態資料已損毀。
ERROR_INVALID_PARAMETER
 不正確參數會傳遞至 函式。
ERROR_MORE_DATA
 提供的緩衝區不足以包含要求的資料。
ERROR_SUCCESS
 已成功擷取 屬性。
ERROR_UNKNOWN_PATCH
 找不到修補程式。
ERROR_UNKNOWN_PRODUCT
 找不到產品。
ERROR_UNKNOWN_PROPERTY
 找不到來源屬性。
ERROR_FUNCTION_FAILED
 非預期的內部失敗。

備註

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

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

注意

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

另請參閱

MsiSourceListSetInfo

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

ProductCode