IVMGuestOS 인터페이스
[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
가상 머신 내에서 실행되는 게스트 운영 체제를 정의합니다. 이 인터페이스를 사용하면 게스트 운영 체제 내에서 실행되는 통합 구성 요소와 상호 작용할 수 있습니다. 가상 머신에 대한 IVMGuestOS 는 IVMVirtualMachine::GuestOS 속성을 사용하여 검색할 수 있습니다.
IVMGuestOS 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IVMGuestOS 에는 다음과 같은 유형의 멤버도 있습니다.
IVMGuestOS 인터페이스에는 이러한 메서드가 있습니다.
메서드 | Description |
---|---|
GetOsVersionInfo | 가상 머신에서 실행되는 게스트 운영 체제에 대한 버전 정보를 검색합니다. |
GetParameter | 게스트 내에서 명명된 매개 변수를 검색합니다. |
InstallIntegrationComponents | 게스트 운영 체제에 최신 통합 구성 요소를 찾아 설치합니다. |
IsUserLoggedOn | 요청된 세션이 있는지 여부를 확인합니다. |
Logoff | 게스트 운영 체제에서 모든 사용자를 로그오프합니다. |
재시작 | 게스트 운영 체제를 다시 시작합니다. |
SetParameter | 게스트 내에서 명명된 매개 변수를 설정합니다. |
종료 | 게스트 운영 체제를 종료합니다. |
IVMGuestOS 인터페이스에는 이러한 속성이 있습니다.
속성 | 액세스 유형 | 설명 |
---|---|---|
CanShutdown |
읽기 전용 |
게스트 운영 체제를 완전히 종료할 수 있는지 여부를 나타냅니다(통합 구성 요소 필요). |
ComputerName |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 컴퓨터 이름입니다. |
CSDVersion |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 CSDVersion입니다. |
HeartbeatPercentage |
읽기 전용 |
지난 1분 동안 받은 예상 하트비트 비율입니다. |
IntegrationComponentsVersion |
읽기 전용 |
게스트 운영 체제에 설치된 통합 구성 요소의 버전입니다. |
IsHeartbeating |
읽기 전용 |
가상 머신에 하트비트가 있는지 여부를 나타냅니다. |
IsHostTimeSyncEnabled |
읽기/쓰기 |
이 가상 머신의 통합 구성 요소가 게스트의 시계를 호스트의 시계와 동기화해야 하는지 여부를 나타냅니다. |
MultipleUserSessionsAllowed |
읽기 전용 |
게스트 운영 체제에서 여러 동시 사용자 세션이 허용되는지 여부를 나타냅니다. |
OSBuildNumber |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 빌드 번호입니다. |
OSMajorVersion |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 주 버전입니다. |
OSMinorVersion |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 부 버전입니다. |
OSName |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 이름입니다. |
OSPlatformId |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 플랫폼 식별자입니다. |
OSVersion |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 버전입니다. |
ProductType |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 제품 유형입니다. |
ScreenLocked |
읽기 전용 |
화면이 게스트 운영 체제에 잠겨 있는지 여부를 나타냅니다. |
ServicePackMajor |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 서비스 팩의 주 버전입니다. |
ServicePackMinor |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 서비스 팩의 부 버전입니다. |
SuiteMask |
읽기 전용 |
가상 머신에서 실행되는 게스트 운영 체제의 SuiteMask입니다. |
TerminalServerPort |
읽기 전용 |
게스트 운영 체제의 원격 데스크톱 서비스에서 사용하는 포트입니다. |
TerminalServicesInitialized |
읽기 전용 |
게스트 운영 체제에서 터미널 서비스 초기화의 상태. |
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
지원되는 최소 서버 |
지원되는 버전 없음 |
클라이언트 지원 종료 |
Windows 7 |
제품 |
Windows Virtual PC |
헤더 |
|
IID |
IID_IVMGuestOS 99fea0db-4880-499a-b6d8-73dff9bc91be로 정의됩니다. |