Product.FeatureState メソッド

FeatureState プロパティは、この製品のインスタンスの機能のインストール状態です。

このプロパティでは、オブジェクトの ProductCodeUserSidContext を使用して 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]
Msi.dll
IID
IID_IProduct が 000C10A0-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

製品

MsiQueryFeatureStateEx

Windows Installer 2.0 以前でのサポート対象外