MsiEnumComponentsExA 函式 （msi.h）

MsiEnumComponentsEx 函式會列舉已安裝的元件。 函式會在每次呼叫元件時擷取一個元件的元件程式代碼。 元件程式代碼是元件、版本和語言唯一的字串 GUID。

Windows Installer 4.5 或更早版本：不支援 。 從 Windows Installer 5.0 開始，即可使用此函式。

語法

UINT MsiEnumComponentsExA(
  [in, optional]  LPCSTR            szUserSid,
  [in]            DWORD             dwContext,
  [in]            DWORD             dwIndex,
  [out, optional] CHAR [39]         szInstalledComponentCode,
  [out, optional] MSIINSTALLCONTEXT *pdwInstalledContext,
  [out, optional] LPSTR             szSid,
  [in, out]       LPDWORD           pcchSid
);

參數

[in, optional] szUserSid

以 Null 結尾的字串，其中包含安全性識別碼 （SID.）已安裝元件的列舉延伸至此 SID 所識別的使用者。 特殊 SID 字串 s-1-1-0 （Everyone） 會指定系統中所有使用者所有產品中所有已安裝元件的列舉。 s-1-1-0 以外的 SID 值會指定特定使用者的使用者 SID，並將列舉限制為指定使用者所安裝之應用程式的實例。

[in] dwContext

旗標，可將已安裝元件的列舉限制為指定安裝內容中所安裝產品實例。 列舉僅包含由 s szUserSid所指定使用者所安裝的產品實例。

[in] dwIndex

指定要擷取之元件的索引。 此參數必須是零 （0），才能第一次 呼叫 msiEnumComponentsEx 函式。 針對每個後續呼叫，索引必須遞增 1。 只有當上一次呼叫函式傳回ERROR_SUCCESS時，才應該遞增索引。 元件不會排序，而且函式可以依任何順序傳回。

[out, optional] szInstalledComponentCode

輸出緩衝區，接收已安裝元件的元件程式代碼 GUID。 緩衝區的長度應該足以容納包含元件程式代碼的 Null 終止字串值。 前 38 個 TCHAR 字元會接收元件的 GUID，而第 39 個字元則會收到終止的 NULL 字元。

[out, optional] pdwInstalledContext

旗標，提供安裝內容安裝元件的應用程式。

[out, optional] szSid

接收安全性識別碼 （SID），識別已安裝擁有元件之應用程式的使用者。 如果應用程式實例安裝在每部計算機安裝內容中，位置就會收到空字串。

這個位置的緩衝區長度應該夠大，足以保存包含 SID 的 Null 終止字串值。 如果緩衝區太小，函式會傳回 ERROR_MORE_DATA，而pcchSid所指向的位置 會接收 SID 中 TCHAR 的數目，不包括終止的 NULL 字元。

如果 szSid 設為 NULL，且 pcchSid 是記憶體中位置的有效指標，則函式會傳回 ERROR_SUCCESS，而且位置會接收 SID 中 TCHAR 的數目，不包括終止的 null 字元。 然後，您可以再次呼叫 函式來擷取值，其中 szSid 緩衝區大小足以包含 *pcchSid + 1 個字元。

[in, out] pcchSid

接收 SID 中 TCHAR 的數目，不包括終止的 Null 字元。 當函式傳回時，此變數會設定為所要求的 SID 大小，不論函式能否成功將 SID 和終止 Null 字元複製到 szSid所指向的緩衝區位置。 大小會以要求值中的 TCHAR 數目傳回，不包括終止的 Null 字元。

只有當 szSid 也 NULL時，這個參數才能設定為 NULL，否則函式會傳回 ERROR_INVALID_PARAMETER。 如果 szSid 和 pcchSid 都設定為 NULL，則函式會傳回 ERROR_SUCCESS SID，而不會擷取 SID 值。

傳回值

MsiEnumProductsEx 函式會傳回下列其中一個值。

言論

要求