Msvm_GuestService::RequestStateChange 메서드

게스트 서비스의 상태를 지정된 값으로 변경하도록 요청합니다.

구문

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

매개 변수

RequestedState [in]

새 상태입니다. RequestStateChange 메서드의 반환 코드가 0 또는 4096인 경우 정보는 instance RequestedState 속성에 배치됩니다. 자세한 내용은 요소에 대한 EnabledState 및 RequestedState 속성에 대한 설명을 참조하세요. 다음 값 중 하나여야 합니다.

사용 (2)

사용 안 함 (3)

종료 (4)

오프라인 (6)

테스트 (7)

연기 (8)

정지 (9)

다시 부팅 (10)

초기화 (11)

DMTF 예약됨 (..)

Vendor Reserved (32768..65535)

작업 [out]

작업이 비동기적으로 실행되는 경우 반환되는 CIM_ConcreteJob 개체에 대한 선택적 참조입니다. 있는 경우 반환된 참조를 사용하여 진행률을 모니터링하고 메서드의 결과를 가져올 수 있습니다.

TimeoutPeriod [in]

클라이언트가 새 상태로 전환할 것으로 예상되는 최대 시간을 지정하는 시간 제한 기간입니다. 시간 제한 기간을 지정하려면 간격 형식을 사용해야 합니다. 값이 0 또는 Null 이면 클라이언트에 전환에 대한 시간 요구 사항이 없음을 나타냅니다. 이 속성에 0 또는 Null 이 포함되어 있지 않고 구현에서 이 매개 변수를 지원하지 않는 경우 반환 코드 4098(시간 제한 매개 변수 사용은 지원되지 않음)이 반환되어야 합니다.

반환 값

이 메서드는 다음 값 중 하나를 반환합니다.

반환 코드/값	설명
오류 없이 완료됨 0	성공했습니다.
지원되지 않음 1
메서드 매개 변수 선택됨 - 전환 시작됨 4096	전환은 비동기입니다.
시간 제한 매개 변수 사용이 지원되지 않음 4098
액세스 거부됨 32769	액세스가 거부되었습니다.
이 작업의 상태가 잘못되었습니다. 32775	RequestedState 매개 변수에 지정된 값은 지원되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버	R2 Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

추가 정보

Msvm_GuestService