Win32_BaseService 클래스의 UserControlService 메서드
WMI 클래스 메서드는 사용자 정의 제어 코드를 서비스에 보내려고 시도합니다.
이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.
구문
uint32 UserControlService(
[in] uint8 ControlCode
);
매개 변수
-
ControlCode [in]
-
서비스에 대한 제어 명령을 지정하는 값입니다. 예를 들어 컨트롤 명령은 "pause" 또는 "continue" 명령입니다. 값은 미리 정의된 코드이거나 서비스에서 정의하는 값 및 작업일 수 있습니다. 다음은 미리 정의된 제어 코드입니다.
-
SERVICE_CONTROL_CONTINUE
-
일시 중지된 서비스에 다시 시작하라는 것을 알 수 있습니다.
-
SERVICE_CONTROL_INTERROGATE
-
서비스에 현재 상태 정보를 서비스 제어 관리자에 보고하도록 알 수 있습니다.
-
SERVICE_CONTROL_NETBINDADD
-
네트워크 서비스에 바인딩을 위한 새 구성 요소가 있음을 알 수 있습니다.
-
SERVICE_CONTROL_NETBINDDISABLE
-
네트워크 서비스에 해당 바인딩 중 하나가 사용하지 않도록 설정되어 있음을 알 수 있습니다.
-
SERVICE_CONTROL_NETBINDENABLE
-
비활성화된 바인딩이 사용하도록 설정되어 있음을 네트워크 서비스에 알 수 있습니다.
-
SERVICE_CONTROL_NETBINDREMOVE
-
바인딩에 대한 구성 요소가 제거되었음을 네트워크 서비스에 알 수 있습니다.
-
SERVICE_CONTROL_PARAMCHANGE
-
서비스에 시작 매개 변수가 변경됨을 알 수 있습니다.
-
SERVICE_CONTROL_PAUSE
-
일시 중지를 서비스에 알 수 있습니다.
-
SERVICE_CONTROL_STOP
-
서비스에 중지를 알 수 있습니다.
반환 값
다음 목록에 나열된 값 중 하나를 반환하거나 오류를 나타내는 다른 값을 반환합니다.
-
Success
-
0
요청이 수락됩니다.
-
지원 안 됨
-
1
요청이 지원되지 않습니다.
-
액세스 거부됨
-
2
사용자에게 필요한 액세스 권한이 없습니다.
-
실행 중인 종속 서비스
-
3
실행 중인 다른 서비스가 이 서비스에 종속되어 있어서 이 서비스를 중지할 수 없습니다.
-
잘못된 서비스 제어
-
4
요청한 제어 코드가 잘못되었거나 서비스에 사용할 수 없습니다.
-
서비스에서 제어를 허용할 수 없음
-
5
요청된 제어 코드는 서비스 상태(Win32_BaseService 때문에 서비스로 보낼 수 없습니다. State 속성)은 0, 1 또는 2와 같습니다.
-
서비스가 활성화되지 않음
-
6
서비스가 시작되지 않았습니다.
-
서비스 요청 시간 제한
-
7
서비스가 시작 요청에 신속하게 응답하지 않습니다.
-
알 수 없는 오류
-
8
대화형 프로세스.
-
경로를 찾을 수 없음
-
9
서비스 실행 파일의 디렉터리 경로를 찾을 수 없습니다.
-
이미 실행 중인 서비스
-
10
서비스가 이미 실행되고 있습니다.
-
서비스 데이터베이스가 잠김
-
11
새 서비스를 추가할 데이터베이스가 잠겨 있습니다.
-
서비스 종속성 삭제됨
-
12
이 서비스가 사용하는 종속성이 시스템에서 제거됩니다.
-
서비스 종속성 오류
-
13
서비스에서 종속 서비스에서 필요한 서비스를 찾을 수 없습니다.
-
서비스 사용 안 함
-
14
시스템에서 서비스를 사용할 수 없습니다.
-
서비스 로그온 실패
-
15
서비스에 시스템에서 실행하기 위한 올바른 인증이 없습니다.
-
삭제로 표시된 서비스
-
16
시스템에서 이 서비스를 제거하는 중입니다.
-
서비스 스레드 없음
-
17
서비스에 대한 실행 스레드가 없습니다.
-
상태 순환 종속성
-
18
서비스 시작 시 순환 종속성이 있습니다.
-
상태 중복 이름
-
19
같은 이름으로 실행 중인 서비스가 있습니다.
-
상태가 잘못된 이름
-
20
서비스 이름에 잘못된 문자가 있습니다.
-
잘못된 상태 매개 변수
-
21
잘못된 매개 변수가 서비스에 전달되었습니다.
-
잘못된 서비스 계정 상태
-
22
이 서비스가 실행되는 계정이 잘못되었거나 서비스를 실행할 수 있는 권한이 없습니다.
-
상태 서비스 존재
-
23
서비스가 시스템에서 사용할 수 있는 서비스 데이터베이스에 있습니다.
-
서비스가 이미 일시 중지됨
-
24
서비스가 현재 시스템에서 일시 중지되었습니다.
-
기타
-
25 4294967295
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 네임스페이스 |
Root\CIMV2 |
| MOF |
|
| DLL |
|