MsiQueryComponentStateA 関数 (msi.h)

  • [アーティクル]

MsiQueryComponentState 関数は、コンポーネントのインストール済み状態を返します。 この関数は、現在のユーザー以外のユーザー アカウントのユーザー アカウントに対するユーザーごとのアンマネージド コンテキストで製品がアドバタイズされない場合に、現在のユーザー以外のユーザー アカウントにインストールされている製品のインスタンスのコンポーネントに対してクエリを実行できます。 現在のユーザー以外のユーザーに対してインストールされた製品の情報を取得するには、呼び出し元プロセスに管理特権が必要です。

構文

UINT MsiQueryComponentStateA(
  [in]  LPCSTR            szProductCode,
  [in]  LPCSTR            szUserSid,
  [in]  MSIINSTALLCONTEXT dwContext,
  [in]  LPCSTR            szComponentCode,
  [out] INSTALLSTATE      *pdwState
);

パラメーター

[in] szProductCode

コンポーネントを含む 製品の ProductCode GUID を指定します。

[in] szUserSid

クエリ対象の製品のインスタンスが存在するアカウントのセキュリティ識別子 (SID) を指定します。 dwContext がMSIINSTALLCONTEXT_MACHINEされていない場合、null は現在のユーザーを指定します。

SID の種類 意味
NULL
 NULL は、現在ログオンしているユーザーを示します。
ユーザー SID
 システム内の特定のユーザーの列挙を指定します。 ユーザー SID の例として、"S-1-3-64-2415071341-1358098788-3127455600-2561" があります。
 
メモ 特別な SID 文字列 "S-1-5-18" (システム) を使用して、コンピューターごとにインストールされている製品を列挙することはできません。 dwContext がMSIINSTALLCONTEXT_MACHINE場合、szUserSid は null である必要があります。
 

[in] dwContext

クエリ対象の製品インスタンスのインストール コンテキスト。

名前 意味
MSIINSTALLCONTEXT_USERMANAGED
 製品のユーザーごとのマネージド インスタンスのコンポーネントの状態を取得します。
MSIINSTALLCONTEXT_USERUNMANAGED
 製品のユーザーごとの非マネージド インスタンスのコンポーネントの状態を取得します。
MSIINSTALLCONTEXT_MACHINE
 製品のマシンごとのインスタンスのコンポーネントの状態を取得します。

[in] szComponentCode

クエリを実行するコンポーネントを指定します。 コンポーネント テーブルの ComponentID 列にあるコンポーネントの コンポーネント コード GUID。

[out] pdwState

指定した製品インスタンスのコンポーネントのインストール状態。 このパラメーターは、次の値または null 値のいずれかを返すことができます。

値 意味
INSTALLSTATE_LOCAL
 コンポーネントはローカルにインストールされます。
INSTALLSTATE_SOURCE
 コンポーネントは、ソースから実行するためにインストールされます。

戻り値

MsiQueryComponentState 関数は、次の値を返します。

値 意味
ERROR_ACCESS_DENIED
 現在のユーザー以外のユーザーに対してインストールされた製品の情報を取得するには、呼び出し元プロセスに管理特権が必要です。
ERROR_BAD_CONFIGURATION
 構成データが破損しています。
ERROR_INVALID_PARAMETER
 無効なパラメーターが関数に渡されました。
ERROR_SUCCESS
 関数は正常に終了しました。
ERROR_UNKNOWN_COMPONENT
 コンポーネント ID では既知のコンポーネントが識別されません。
ERROR_UNKNOWN_PRODUCT
 製品コードでは既知の製品が識別されません。
ERROR_FUNCTION_FAILED
 Windows エラー コードに割り当てることができないエラー。
ERROR_MORE_DATA
 バッファーが小さすぎてユーザー SID を取得できません。
 

詳細については、「 表示されたエラー メッセージ」を参照してください。

注釈

注意

msi.h ヘッダーは、MSIQueryComponentState をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows インストーラーのバージョンで必要な最小 Windows サービス パックに関する情報については、Windows インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム Windows
ヘッダー msi.h
Library Msi.lib
[DLL] Msi.dll

こちらもご覧ください

コンポーネント

表示されるエラー メッセージ

インストーラーの選択関数

Windows インストーラー 2.0 以前ではサポートされていません

ProductCode