MsiServiceConfigFailureActions 테이블

  • 아티클

MsiServiceConfigFailureActions 테이블에는 서비스가 실패한 후 실행할 작업이 나열됩니다. 이 테이블에 지정된 작업은 다음에 시스템이 시작될 때 실행됩니다.

Windows Installer 4.5 이하: 지원되지 않습니다. 이 테이블은 Windows Installer 5.0부터 사용할 수 있습니다.

MsiServiceConfigFailureActions 테이블에는 다음과 같은 열이 있습니다.

Column 형식 키 Nullable
MsiServiceConfigFailureActions 식별자 Y N
속성 Formatted N N
이벤트 정수 N N
ResetPeriod 정수 N Y
RebootMessage Formatted N Y
명령 Formatted N Y
동작 Text N Y
DelayActions Text N Y
Component_ 식별자 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
 작업이 필요 없습니다.
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