次の方法で共有

MsiQueryFeatureStateExA 関数 (msi.h)

  • [アーティクル]

MsiQueryFeatureStateEx 関数は、製品機能のインストール済み状態を返します。 この関数を使用すると、マシン アカウントにインストールされている製品のインスタンスの任意の機能、または現在のユーザー アカウントのコンテキスト、または現在のユーザー以外の任意のユーザー アカウントのユーザーごとの管理コンテキストに対してクエリを実行できます。 ユーザーは、現在のユーザー以外のユーザーに対してインストールされた製品の情報を取得するための管理特権を持っている必要があります。

構文

UINT MsiQueryFeatureStateExA(
  [in]            LPCSTR            szProductCode,
  [in]            LPCSTR            szUserSid,
  [in]            MSIINSTALLCONTEXT dwContext,
  [in]            LPCSTR            szFeature,
  [out, optional] 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] szFeature

クエリを実行する機能を指定します。 フィーチャ テーブルの [フィーチャ] 列にあるフィーチャの識別子。

[out, optional] pdwState

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

価値 意味
INSTALLSTATE_ADVERTISED
 この機能はアドバタイズされます。
INSTALLSTATE_LOCAL
 この機能はローカルにインストールされます。
INSTALLSTATE_SOURCE
 この機能は、ソースから実行するためにインストールされます。

戻り値

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

価値 意味
ERROR_ACCESS_DENIED
 ユーザーは、現在のユーザー以外のユーザーに対してインストールされた製品の情報を取得するための管理特権を持っている必要があります。
ERROR_BAD_CONFIGURATION
 構成データが破損しています。
ERROR_INVALID_PARAMETER
 無効なパラメーターが関数に渡されました。
ERROR_SUCCESS
 関数は正常に完了しました。
ERROR_UNKNOWN_FEATURE
 機能 ID は既知の機能を識別しません。
ERROR_UNKNOWN_PRODUCT
 製品コードは既知の製品を識別しません。
ERROR_FUNCTION_FAILED
 予期しない内部エラー。
 

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

備考

MsiQueryFeatureStateEx 関数は、機能が実際にアクセス可能であることを検証しません。 MsiQueryFeatureStateEx 関数は機能 ID を検証しません。 不明な機能 ID に対して ERROR_UNKNOWN_FEATURE が返されます。 現在のユーザー以外のユーザー アカウントのユーザーごとのアンマネージド コンテキストでインストールされている製品に対してクエリを実行すると、関数は失敗します。 この場合、関数は ERROR_UNKNOWN_FEATUREを返すか、製品がアドバタイズされている場合 (インストールされていない場合)、ERROR_UNKNOWN_PRODUCT が返されます。

手記

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

必要条件

要件 価値
サポートされる最小クライアント 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 Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll

関連項目

表示されたエラー メッセージの

フィーチャ テーブル の

MsiQueryFeatureState

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

ProductCode を する

システムステータス機能