Product.FeatureState メソッド
FeatureState プロパティは、この製品のインスタンスの機能のインストール状態です。
このプロパティでは、オブジェクトの ProductCode、UserSid、Context を使用して MsiQueryFeatureStateEx を呼び出します。 機能 ID はパラメーターとして提供されます。
構文
Product.FeatureState(
FeatureId
)
パラメーター
-
FeatureId
-
Feature テーブルの Feature 列に表示される機能 ID。
戻り値
このメソッドは値を返しません。
解説
呼び出しが成功した場合、プロパティには値が DWORD として含まれます。
| State | 意味 |
|---|---|
| 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 | 予期しない内部エラー。 |
必要条件
| 要件 | 値 |
|---|---|
| バージョン |
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 Server 2003、Windows XP、Windows 2000 上の Windows インストーラー 3.0 以降 |
| [DLL] |
|
| IID |
IID_IProduct が 000C10A0-0000-0000-C000-000000000046 として定義されている |
こちらもご覧ください