IVMGuestOS::GetParameter 메서드

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

게스트 운영 체제 내에서 명명된 매개 변수를 검색합니다.

구문

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

inParameterName [in]: 매개 변수 이름입니다. 길이는 1~255자여야 하며 백슬래시(\) 문자를 포함할 수 없습니다.
outParameterValue [out, retval]: 매개 변수 값입니다.

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

반환 코드/값	Description
S_OK 0	작업이 완료되었습니다.
E_INVALIDARG 0x80000003	매개 변수가 잘못되었거나 지정되지 않았습니다.
E_POINTER 0x80004003	매개 변수가 NULL입니다.
VM_E_TIMED_OUT 0xA0040202	작업이 적시에 완료되지 않았습니다.
VM_E_VM_NOT_RUNNING 0xA0040206	가상 머신이 실행되고 있지 않습니다.
VM_E_VM_PAUSED 0xA00400507	가상 머신이 일시 중지되었습니다.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	통합 구성 요소는 이 가상 머신에 설치되지 않습니다.
DISP_E_EXCEPTION 0x80020009	예기치 않은 오류가 발생했습니다.

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

통합 구성 요소가 설치되면 다음 키가 게스트 운영 체제의 레지스트리에 자동으로 추가됩니다.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

게스트 운영 체제가 시작되면 다음 레지스트리 문자열 값이 매개 변수 키에 채워집니다.

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