MsiServiceConfigFailureActions テーブル

  • [アーティクル]

MsiServiceConfigFailureActions テーブルには、サービスが失敗した後に実行される操作が一覧表示されます。 このテーブルに指定された操作は、次回システムが開始されるときに実行されます。

Windows インストーラー 4.5 以前: サポートされていません。 このテーブルは、Windows インストーラー 5.0 以降で使用できます。

MsiServiceConfigFailureActions テーブルには以下の列があります。

Column 種類 キー Nullable
MsiServiceConfigFailureActions Identifier Y N
名前 Formatted N N
イベント 整数 N N
ResetPeriod 整数 N Y
RebootMessage 書式設定済み N Y
command Formatted N Y
アクション テキスト N Y
DelayActions テキスト N Y
Component_ Identifier N N

 

[列]

MsiServiceConfigFailureActions

これは、エラー アクションを識別するこのテーブルの主キーです。

Name

この列には、このパッケージの一部であるか、既にインストールされている、サービスの名前が含まれています。

Event

この列は、サービス構成を変更するタイミングを指定します。 次の値は、組み合わせて複数の操作を表すことのできるビット フィールドです。 その他のビット フィールド値は無視されます。

定数 説明
msidbServiceConfigEventInstall1
 コンポーネントのインストール中に変更します。
msidbServiceConfigEventUninstall2
 コンポーネントのアンインストール中に変更します。
msidbServiceConfigEventReinstall4
 コンポーネントの再インストール中に変更します。

 

ResetPeriod

サービスのエラー数のリセット期間 (秒単位)。 サービス コントロール マネージャー (SCM) は、システムが最後に再起動されてから各サービスが失敗した回数をカウントします。 リセット期間にサービスが失敗しない場合、カウントは 0 にリセットされます。 サービスが N 回目に失敗すると、Actions フィールドで指定された配列の要素 [N-1] に指定されたアクションがシステムにより実行されます。

ResetPeriod フィールドを空のままにして、エラー数をリセットしてはならないことを示します。

RebootMessage

Actions 列で指定された SC_ACTION_REBOOT アクションに応答して、コンピューターを再起動する前にユーザーに送信されたメッセージ。 空の文字列 "" を使用して、現在のメッセージを変更せずに送信できます。 現在のメッセージを削除して、メッセージを送信しない場合は、Formatted データ型の [~] 構文を使用できます。

Command

Actions 列に指定された SC_ACTION_RUN_COMMAND アクションに応答して CreateProcess 関数によって作成されたプロセスによって実行されるコマンド ライン。 新しいプロセスは、サービスと同じアカウントで実行され、Action フィールドが SC_ACTION_RUN_COMMAND である場合にのみ実行されます。 空の文字列 "" を使用して、現在のコマンド ラインを変更せずに使用できます。 現在のコマンド ラインを削除し、サービスが失敗したときに操作を実行しない場合は、Formatted データ型の [~] 構文を使用できます。

Actions

このフィールドには、サービスが失敗した場合に SCM によって実行されるアクションを指定する整数値の配列が含まれています。 配列内の値を [~] で区切ります。 配列の N 番目の要素の整数値は、サービスが N 回目に失敗したときに実行されるアクションを指定します。 配列の各メンバーは、次のいずれかの整数値です。

定数 説明
SC_ACTION_NONE0
 NO ACTION
SC_ACTION_REBOOT2
 コンピューターを再起動します。
SC_ACTION_RESTART1
 サービスを再起動します。
SC_ACTION_RUN_COMMAND3
 コマンドを実行します。

 

DelayActions

このフィールドには、Action 列で指定されたアクションを実行するまでの待機時間をミリ秒単位で指定する整数値の配列が含まれています。 配列内の値を [~] で区切ります。 DelayActions 配列内の要素の数は、Actions 配列内の要素の数と等しい必要があります。 DelayActions 配列の N 番目の要素は、Actions 配列の n 番目の要素の遅延時間を指定します。

Component_

Component テーブルの列 1 の外部キー。

検証

ICE102
ICE03
ICE06
ICE32
ICE45
ICE46
ICE69