Session.SetInstallLevel メソッド

  • [アーティクル]

Session オブジェクトの SetInstallLevel メソッドは、現在のインストールのインストール レベルを指定した値に設定し、Feature テーブル内のすべての機能の Select 状態と Installed 状態を再計算します。 また、新しいレベルに基づいて、Component テーブル 内の各コンポーネントのアクション状態も設定します。

構文

Session.SetInstallLevel(
  installLevel
)

パラメーター

installLevel

要求される必須の新しいインストール レベル。

戻り値

このメソッドは値を返しません。

解説

CostInitialize アクションは、SetInstallLevel を呼び出す前に実行する必要があります。

installLevel パラメーターに 0 を渡した場合、現在のインストール レベルは変更されませんが、すべての機能は現在のインストール レベルに基づいて更新されます。 たとえば、この機能を Handler モジュールで使用すると、UI 選択プロセスの任意の時点で、すべての選択を最初の既定の状態にリセットできます。

メソッドが失敗した場合は、LastErrorRecord メソッドを使用して拡張エラー情報を取得できます。

必要条件

要件 値
バージョン
 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 インストーラー
[DLL]
Msi.dll
IID
 IID_ISession が 000C109E-0000-0000-C000-000000000046 として定義されている