ServiceBase.OnCustomCommand(Int32) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파생 클래스에서 구현되는 경우 OnCustomCommand(Int32)는 SCM(서비스 컨트롤 관리자)이 서비스에 사용자 지정 명령을 전달할 때 실행됩니다. 지정된 매개 변수 값을 사용하는 명령이 발생할 때 수행할 동작을 지정합니다.
protected:
virtual void OnCustomCommand(int command);protected virtual void OnCustomCommand (int command);abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unitProtected Overridable Sub OnCustomCommand (command As Integer)매개 변수
- command
- Int32
서비스에 전달된 명령 메시지입니다.
설명
OnCustomCommand 에서는 서비스를 시작, 중지, 일시 중지 및 계속하는 것 외에 추가 기능을 지정할 수 있습니다.
SCM은 서비스에서 전달된 매개 변수를 지원하는 command 지 여부를 확인하기 위해 사용자 지정 명령을 검사하지 않습니다. 사용자 지정 명령을 서비스에 직접 전달합니다. 서비스에서 매개 변수를 command 인식하지 못하는 경우 아무 것도 수행하지 않습니다.
사용자 지정 명령은 구성 요소의 ExecuteCommand 문에 ServiceController 의해 발생합니다. switch 문 또는 if를 사용합니다. 그런 다음 서비스에 정의한 사용자 지정 명령을 처리하는 조건을 지정합니다.
애플리케이션에서 정의 하거나에서 사용할 수 있는 사용자 지정 명령에 대 한 값만 OnCustomCommand 128과 255 사이의 됩니다. 128 미만의 정수는 시스템 예약 값에 해당합니다.
속성이 AutoLog true다른 모든 명령과 마찬가지로 사용자 지정 명령인 경우 이벤트 로그에 항목을 작성하여 메서드 실행 성공 또는 실패 여부를 보고합니다.