다음을 통해 공유


CIM_EnabledLogicalElement 클래스의 RequestStateChange 메서드

요소의 상태를 RequestedState 매개 변수에 지정된 값으로 변경하도록 요청합니다. 요청된 상태 변경이 발생하면 요소의 EnabledState 및 RequestedState가 동일합니다. RequestStateChange 메서드를 여러 번 호출하면 이전 요청을 덮어쓰거나 손실할 수 있습니다.

구문

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

매개 변수

RequestedState [in]

요소에 대해 요청된 상태입니다. RequestStateChange 메서드의 반환 코드가 0('오류 없이 완료됨') 또는 4096(0x1000)('작업 시작됨')인 경우 이 정보는 instance RequestedState 속성에 배치됩니다. RequestedState 값에 대한 자세한 설명은 EnabledStateRequestedState 속성의 설명을 참조하세요.

시작 (2)

상태를 '실행 중'으로 변경합니다.

일시 중단 (3)

작업을 일시적으로 중지합니다. 이후에 '시작'을 사용하여 작업을 다시 시작하려고 합니다. 일시 중단된 상태에서 '서비스' 상태를 입력할 수 있습니다. (작업에 따라 다릅니다.)

Terminate (4)

작업을 깔끔하게 중지하고, 데이터를 저장하고, 상태를 유지하며, 모든 기본 프로세스를 순서대로 종료합니다.

(5)

데이터를 저장하거나 상태를 보존할 필요가 없도록 작업을 즉시 종료합니다.

서비스 (6)

작업을 공급업체별 서비스 상태로 전환합니다. 작업을 다시 시작할 수 있습니다.

DMTF 예약됨 (7..32767)

Vendor Reserved (32768..65535)

작업 [out]

메서드 호출에서 시작된 상태 전환을 추적하기 위해 만든 CIM_ConcreteJob 대한 참조를 포함할 수 있습니다.

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_EnabledLogicalElement