SERVICE_STATUS 구조체(winsvc.h)

서비스에 대한 상태 정보를 포함합니다. ControlService, EnumDependentServices, EnumServicesStatus 및 QueryServiceStatus 함수는 이 구조를 사용합니다. 서비스는 SetServiceStatus 함수에서 이 구조를 사용하여 현재 상태 서비스 제어 관리자에 보고합니다.

구문

typedef struct _SERVICE_STATUS {
  DWORD dwServiceType;
  DWORD dwCurrentState;
  DWORD dwControlsAccepted;
  DWORD dwWin32ExitCode;
  DWORD dwServiceSpecificExitCode;
  DWORD dwCheckPoint;
  DWORD dwWaitHint;
} SERVICE_STATUS, *LPSERVICE_STATUS;

멤버

dwServiceType

서비스의 유형입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

서비스 유형이 SERVICE_WIN32_OWN_PROCESS 또는 SERVICE_WIN32_SHARE_PROCESS 있고 서비스가 LocalSystem 계정의 컨텍스트에서 실행되는 경우 다음 형식도 지정할 수 있습니다.

dwCurrentState

서비스의 현재 상태입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

dwControlsAccepted

처리기 함수에서 서비스에서 수락하고 처리하는 컨트롤 코드입니다( Handler 및 HandlerEx 참조). 사용자 인터페이스 프로세스는 ControlService 또는 ControlServiceEx 함수에서 컨트롤 명령을 지정하여 서비스를 제어 할 수 있습니다. 기본적으로 모든 서비스는 SERVICE_CONTROL_INTERROGATE 값을 허용합니다.

SERVICE_CONTROL_DEVICEEVENT 값을 허용하려면 서비스에서 RegisterDeviceNotification 함수를 사용하여 디바이스 이벤트를 수신하도록 등록해야 합니다.

다음은 제어 코드입니다.

이 멤버는 HandlerEx에서만 지원되는 다음과 같은 확장된 제어 코드를 포함할 수도 있습니다. (이러한 컨트롤 코드는 ControlService 또는 ControlServiceEx에서 보낼 수 없습니다.)

dwWin32ExitCode

서비스가 시작 또는 중지할 때 발생하는 오류를 보고하는 데 사용하는 오류 코드입니다. 서비스와 관련된 오류 코드를 반환하려면 dwServiceSpecificExitCode 멤버에 오류 코드가 포함되어 있음을 나타내기 위해 이 값을 ERROR_SERVICE_SPECIFIC_ERROR 설정해야 합니다. 서비스가 실행 중일 때와 정상 종료 시 이 값을 NO_ERROR 설정해야 합니다.

dwServiceSpecificExitCode

서비스가 시작되거나 중지되는 동안 오류가 발생할 때 서비스가 반환하는 서비스별 오류 코드입니다. dwWin32ExitCode 멤버가 ERROR_SERVICE_SPECIFIC_ERROR 설정되지 않으면 이 값은 무시됩니다.

dwCheckPoint

긴 시작, 중지, 일시 중지 또는 계속 작업 중에 진행 상황을 보고하기 위해 서비스가 주기적으로 증가하는 검사 지점 값입니다. 예를 들어 서비스는 시작할 때 초기화의 각 단계를 완료할 때 이 값을 증가시켜야 합니다. 서비스에서 작업을 호출한 사용자 인터페이스 프로그램은 이 값을 사용하여 긴 작업 중에 서비스의 진행률을 추적합니다. 이 값은 유효하지 않으며 서비스에 보류 중인 시작, 중지, 일시 중지 또는 계속 작업이 없는 경우 0이어야 합니다.

dwWaitHint

보류 중인 시작, 중지, 일시 중지 또는 계속 작업에 필요한 예상 시간(밀리초)입니다. 지정된 시간이 경과하기 전에 서비스는 증가된 dwCheckPoint 값 또는 dwCurrentState 변경으로 SetServiceStatus 함수에 대한 다음 호출을 수행해야 합니다. dwWaitHint에서 지정한 시간이 지나고 dwCheckPoint가 증가하지 않았거나 dwCurrentState가 변경되지 않은 경우 서비스 제어 관리자 또는 서비스 제어 프로그램에서 오류가 발생하고 서비스를 중지해야 한다고 가정할 수 있습니다. 그러나 서비스가 다른 서비스와 프로세스를 공유하는 경우 서비스 제어 관리자는 프로세스를 공유하는 다른 서비스도 종료해야 하므로 서비스 애플리케이션을 종료할 수 없습니다.

요구 사항

추가 정보

ControlService

ControlServiceEx

EnumDependentServices

EnumServicesStatus

QueryServiceStatus

SetServiceStatus