Tabela MsiServiceConfigFailureActions

A tabela MsiServiceConfigFailureActions lista as operações a serem executadas depois que um serviço falha. As operações especificadas nesta tabela são executadas na próxima vez que o sistema é iniciado.

Windows Installer 4.5 ou versões anteriores: sem suporte. Esta tabela está disponível a partir do Windows Installer 5.0.

A tabela MsiServiceConfigFailureActions contém as seguintes colunas.

Coluna Tipo Chave Nullable
MsiServiceConfigFailureActions Identificador S N
Nome Formatted N N
Evento Inteiro N N
ResetPeriod Inteiro N S
RebootMessage Formatted N Y
Comando Formatted N S
Ações Texto N S
DelayActions Texto N S
Component_ Identificador N N

 

Colunas

MsiServiceConfigFailureActions

Essa é a chave primária desta tabela, que identifica uma ação de falha.

Name

Esta coluna contém o nome de um serviço que faz parte desse pacote ou que já está instalado.

Event

Esta coluna especifica quando alterar a configuração do serviço. Os valores a seguir são campos de bits que podem ser combinados para representar várias operações. Quaisquer outros valores de campo de bit são ignorados.

Constante Descrição
msidbServiceConfigEventInstall1
Alteração durante a instalação do componente.
msidbServiceConfigEventUninstall2
Alteração durante a desinstalação do componente.
msidbServiceConfigEventReinstall4
Alteração durante a reinstalação do componente.

 

ResetPeriod

O período de redefinição em segundos da contagem de falhas do serviço. O SCM ( Service Control Manager) conta o número de vezes que cada serviço falhou desde que o sistema foi reiniciado pela última vez. A contagem será redefinida para zero se o serviço não falhar no período de redefinição. Quando o serviço falha pela nª vez, o sistema executa a ação especificada no elemento [N-1] da matriz especificada no campo Actions.

Deixe o campo ResetPeriod vazio para indicar que a contagem de falhas nunca deve ser redefinida.

RebootMessage

A mensagem enviada aos usuários antes de reiniciar o computador em resposta a uma ação SC_ACTION_REBOOT especificada na coluna Actions. Você pode usar uma cadeia de caracteres vazia, "", para enviar a mensagem atual inalterada. Você pode usar a sintaxe [~] do tipo de dados Formatted para excluir a mensagem atual e não enviar nenhuma mensagem.

Command

A linha de comando executada pelo processo criado pela função CreateProcess em resposta a uma ação SC_ACTION_RUN_COMMAND especificada na coluna Actions. O novo processo é executado na mesma conta que o serviço e somente se o campo Action for SC_ACTION_RUN_COMMAND. Você pode usar uma cadeia de caracteres vazia, "", para usar a linha de comando atual inalterada. Você pode usar a sintaxe [~] do tipo de dados Formatted para excluir a linha de comando atual e não executar nenhuma operação quando o serviço falhar.

Actions

Esse campo contém uma matriz de valores inteiros que especificam as ações executadas pelo SCM se o serviço falhar. Separe os valores na matriz por [~]. O valor inteiro no elemento n da matriz especifica a ação executada quando o serviço falha pela enésima vez. Cada membro da matriz é um dos seguintes valores inteiros.

Constante Descrição
SC_ACTION_NONE0
Nenhuma ação.
SC_ACTION_REBOOT2
Reinicie o computador.
SC_ACTION_RESTART1
Reinicie o serviço.
SC_ACTION_RUN_COMMAND3
Execute um comando.

 

DelayActions

Esse campo contém uma matriz de valores inteiros que especificam o tempo em milissegundos a aguardar antes de executar a ação especificada na coluna Action. Separe os valores na matriz por [~]. O número de elementos na matriz DelayActions deve ser igual ao número de elementos na matriz Actions. O enésimo elemento da matriz DelayActions especifica o atraso de tempo para o enésimo elemento da matriz Actions.

Component_

Chave externa da primeira coluna da tabela Component.

Validação

ICE102
ICE03
ICE06
ICE32
ICE45
ICE46
ICE69