IVMGuestOS::Shutdown 메서드

[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]

VM(가상 머신)에서 게스트 운영 체제를 종료합니다.

구문

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

isForced [in]: VARIANT_TRUE 종료가 강제로 수행되면 VARIANT_FALSE 그렇지 않습니다.
outShutdownTask [out, retval]: 종료 프로세스의 완료를 추적하는 데 사용되는 IVMTask 개체입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값	Description
S_OK 0	작업이 완료되었습니다.
E_POINTER 0x80004003	outShutdownTask 매개 변수는 NULL입니다.
VM_E_TIMED_OUT 0xA0040202	작업이 적시에 완료되지 않았습니다.
VM_E_VM_UNKNOWN 0xA0040207	VM을 찾을 수 없습니다.
VM_E_VM_NOT_RUNNING 0xA0040206	이 작업을 위해 VM이 실행 중이어야 합니다.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	호출자에게 이 VM에 대한 실행 액세스 권한이 있어야 합니다.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	통합 구성 요소 기능은 이 VM에 설치되어 있지 않습니다.
DISP_E_EXCEPTION 0x80020009	예기치 않은 오류가 발생했습니다.

VM이 실행 중이어야 하며 이 메서드를 호출할 때 통합 구성 요소 기능을 설치해야 합니다. 이 방법은 Windows 기반 게스트 운영 체제에서만 지원됩니다.

반환된 IVMTask 개체의 Error 속성을 통해 다음 값을 반환할 수 있습니다.

오류 코드/값	Description
`HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)` (0x80070005)	호출자에게 이 VM에 대한 실행 액세스 권한이 있어야 합니다.
`HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED)` (0x800704f7)	컴퓨터가 잠겨 있으며 강제 옵션 없이는 종료할 수 없습니다.
`HRESULT_FROM_WIN32(ERROR_NOT_READY)` (0x80070015)	디바이스가 준비되지 않았습니다.
`HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS)` (0x8007045b)	시스템 종료가 진행 중입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
클라이언트 지원 종료	Windows 7
제품	Windows Virtual PC
헤더	VPCCOMInterfaces.h
IID	IID_IVMGuestOS 99fea0db-4880-499a-b6d8-73dff9bc91be로 정의됩니다.