MsiQueryFeatureStateExW 関数 (msi.h)
MsiQueryFeatureStateEx 関数は、製品機能のインストール済み状態を返します。 この関数を使用すると、マシン アカウントの下にインストールされている製品のインスタンスの任意の機能、または現在のユーザー アカウントのコンテキスト、または現在のユーザー以外の任意のユーザー アカウントのユーザーごとの管理コンテキストに対してクエリを実行できます。 現在のユーザー以外のユーザーに対してインストールされている製品の情報を取得するには、ユーザーに管理者権限が必要です。
構文
UINT MsiQueryFeatureStateExW(
[in] LPCWSTR szProductCode,
[in] LPCWSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] LPCWSTR szFeature,
[out, optional] INSTALLSTATE *pdwState
);
パラメーター
[in] szProductCode
Productcode 目的の機能を含む製品の GUID。
[in] szUserSid
クエリ対象の製品のインスタンスが存在するアカウントのセキュリティ識別子 (SID) を指定します。 dwContext がMSIINSTALLCONTEXT_MACHINEされていない場合、null 値は現在のユーザーを指定します。
| SID の種類 | 説明 |
|---|---|
|
NULL は、現在ログオンしているユーザーを示します。 |
|
システム内の特定のユーザーの列挙を指定します。 ユーザー SID の例として、"S-1-3-64-2415071341-1358098788-3127455600-2561" があります。 |
[in] dwContext
クエリ対象の製品インスタンスのインストール コンテキスト。
[in] szFeature
クエリを実行する機能を指定します。 フィーチャー テーブルの [フィーチャー] 列にある特徴の識別子。
[out, optional] pdwState
指定した製品インスタンスの機能のインストール状態。 このパラメーターは、次または null のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
この機能はアドバタイズされます。 |
|
機能はローカルにインストールされます。 |
|
機能はソースから実行されるようにインストールされます。 |
戻り値
MsiQueryFeatureStateEx 関数は、次の値を返します。
| 値 | 説明 |
|---|---|
|
現在のユーザー以外のユーザーに対してインストールされている製品の情報を取得するには、ユーザーに管理者権限が必要です。 |
|
構成データが破損しています。 |
|
無効なパラメーターが関数に渡されました。 |
|
関数は正常に終了しました。 |
|
機能 ID では、既知の機能は識別されません。 |
|
製品コードでは既知の製品が識別されません。 |
|
予期しない内部エラー。 |
詳細については、「 表示されたエラー メッセージ」を参照してください。
解説
MsiQueryFeatureStateEx 関数は、機能が実際にアクセス可能であることを検証しません。 MsiQueryFeatureStateEx 関数は、機能 ID を検証しません。 ERROR_UNKNOWN_FEATURE は、不明な機能 ID に対して返されます。 現在のユーザー以外のユーザー アカウントのユーザーごとのアンマネージド コンテキストでインストールされている製品に対してクエリを実行すると、関数は失敗します。 この場合、関数は ERROR_UNKNOWN_FEATUREを返すか、製品がアドバタイズされる (インストールされていない) 場合は 、ERROR_UNKNOWN_PRODUCT が返されます。
Note
msi.h ヘッダーは、MSIQueryFeatureStateEx をエイリアスとして定義し、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 |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示