Msvm_GuestServiceInterfaceComponent::RequestStateChange 메서드

게스트 서비스 인터페이스 구성 요소의 상태를 지정된 값으로 변경하도록 요청합니다.

구문

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

매개 변수

RequestedState [in]

형식: uint16

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

사용 (2)

사용 안 함 (3)

종료 (4)

오프라인 (6)

테스트 (7)

연기 (8)

정지 (9)

다시 부팅 (10)

초기화 (11)

DMTF 예약 됨(..)

Vendor Reserved (32768..65535)

작업 [out]

형식: CIM_ConcreteJob

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

TimeoutPeriod [in]

형식: datetime

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

반환 값

형식: uint32

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

반환 코드/값	설명
오류 없이 완료됨 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

추가 정보

Msvm_GuestServiceInterfaceComponent