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	WindowsVirtualization.V2.mof
DLL	Vmms.exe

추가 정보

CIM_ConcreteJob