IVMVirtualMachine::GetConfigurationValue 메서드

  • 아티클

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

이 가상 머신에 대해 지정된 구성 설정의 값을 검색합니다.

구문

HRESULT GetConfigurationValue(
  [in]          BSTR    configurationKey,
  [out, retval] VARIANT *configurationValue
);

매개 변수

configurationKey [in]

"*.vmc" 파일에 저장된 구성 값을 식별하는 데 사용되는 키입니다.

configurationValue [out, retval]

구성 값입니다. 이 값은VT_ARRAY VT_UI1(원시 바이트), VT_BSTR|(문자열), VT_I4(정수) 또는 VT_BOOL(부울) 형식 중 하나일 수 있습니다.

반환 값

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

반환 코드/값 Description
S_OK
0
 작업이 완료되었습니다.
E_INVALIDARG
0x80000003
 configurationKey 매개 변수가 NULL이거나 비어 있습니다.
E_POINTER
0x80004003
 configurationValue 매개 변수는 NULL입니다.
VM_E_VM_UNKNOWN
0xA0040207
 구성을 알 수 없습니다.
VM_E_PREF_NOT_FOUND
0xA0040300
 기본 설정을 찾을 수 없습니다.
DISP_E_EXCEPTION
0x80020009
 예기치 않은 오류가 발생했습니다.

설명

이 메서드는 모든 구성 값에 대한 낮은 수준의 액세스를 제공합니다. 고객 정의 키에 대한 구성 값을 읽는 데 사용할 수 있습니다.

구성 키는 가상 머신의 "*.vmc" 파일에 XML 형식으로 있습니다. 키는 Windows의 레지스트리 키와 유사한 계층적 방식으로 저장됩니다. 특정 하위 키를 지정하기 위해 슬래시 표시로 구분된 형식으로 다양한 키를 지정하는 "키 경로"가 생성됩니다.

예를 들어 다음 키 트리에 있는 "ram_size" 키의 값을 읽으려면 다음을 수행합니다.

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

configurationKey 경로 문자열은 다음과 같이 지정됩니다.

"hardware/memory/ram_size"

원하는 트리의 키에 "id" 특성 값이 있는 경우 특성과 해당 값은 대괄호로 묶인 형식 "[@id="id_value"]을 사용하여 연결된 구성 키 바로 뒤의 configurationKey 경로 문자열에 포함됩니다.

예를 들어 다음 키 트리에 있는 "절대" 키의 값을 읽으려면 다음을 수행합니다.

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

configurationKey 경로 문자열은 다음과 같이 지정됩니다.

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
클라이언트 지원 종료
 Windows 7
제품
 Windows Virtual PC
헤더
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다.

추가 정보

IVMVirtualMachine