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 の外部キー。
検証