CIM_ConcreteJob 클래스의 RequestStateChange 메서드
작업 상태를 RequestedState 매개 변수에 지정된 값으로 변경하도록 요청합니다. RequestStateChange 메서드를 여러 번 호출하면 이전 요청을 덮어쓰거나 손실할 수 있습니다.
0이 반환되면 작업이 성공적으로 완료됩니다. 다른 반환 코드는 오류 조건을 나타냅니다.
구문
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
매개 변수
-
RequestedState [in]
-
작업을 요청할 상태입니다. 가능한 값은 다음과 같습니다.
-
시작 (2)
-
상태를 '실행 중'으로 변경합니다.
-
일시 중단 (3)
-
작업을 일시적으로 중지합니다. 이후에 '시작'을 사용하여 작업을 다시 시작하려고 합니다. 일시 중단된 상태에서 '서비스' 상태를 입력할 수 있습니다. (작업에 따라 다릅니다.)
-
Terminate (4)
-
작업을 깔끔하게 중지하고, 데이터를 저장하고, 상태를 유지하며, 모든 기본 프로세스를 순서대로 종료합니다.
-
킬 (5)
-
데이터를 저장하거나 상태를 보존할 필요가 없도록 작업을 즉시 종료합니다.
-
서비스 (6)
-
작업을 공급업체별 서비스 상태로 전환합니다. 작업을 다시 시작할 수 있습니다.
-
DMTF 예약됨 (7..32767)
-
Vendor Reserved (32768..65535)
TimeoutPeriod [in]
클라이언트가 새 상태로 전환할 것으로 예상되는 최대 시간을 지정하는 시간 제한 기간입니다. 시간 제한 기간을 지정하려면 간격 형식을 사용해야 합니다. 값이 0 또는 Null 이면 클라이언트에 전환에 대한 시간 요구 사항이 없음을 나타냅니다. 이 속성에 0 또는 Null 이 포함되어 있지 않고 구현에서 이 매개 변수를 지원하지 않는 경우 반환 코드 4098(시간 제한 매개 변수 사용은 지원되지 않음)이 반환되어야 합니다.
반환 값
성공하면 0을 반환합니다. 그렇지 않으면 에서 오류를 반환합니다.
-
오류 없이 완료됨 (0)
-
지원되지 않음 (1)
-
알 수 없음/지정되지 않은 오류 (2)
-
제한 시간 내에 완료할 수 없음 (3)
-
실패( 4)
-
잘못된 매개 변수 (5)
-
사용 중 (6)
-
DMTF 예약됨 (..)
-
메서드 매개 변수 선택됨 - 전환 시작됨 (4096)
-
잘못된 상태 전환 (4097)
-
시간 제한 매개 변수 사용이 지원되지 않음 (4098)
-
사용 중 (4099)
-
예약된 메서드 (4100..32767)
-
공급업체별 (32768..65535)
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 8.1 |
| 지원되는 최소 서버 |
Windows Server 2012 R2 |
| 네임스페이스 |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|