IVMGuestOS 인터페이스

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

가상 머신 내에서 실행되는 게스트 운영 체제를 정의합니다. 이 인터페이스를 사용하면 게스트 운영 체제 내에서 실행되는 통합 구성 요소와 상호 작용할 수 있습니다. 가상 머신에 대한 IVMGuestOSIVMVirtualMachine::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
헤더
VPCCOMInterfaces.h
IID
IID_IVMGuestOS 99fea0db-4880-499a-b6d8-73dff9bc91be로 정의됩니다.