IVMVirtualMachine::SetConfigurationValue 메서드

  • 아티클

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

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

구문

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

매개 변수

configurationKey [in]

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

중요

SetConfigurationValue 메서드를 사용하여 "*.vmc"를 변경해야 합니다. 다른 메서드를 사용하여 "*.vmc"를 변경하는 것은 지원되지 않습니다.

configurationValue [in]

구성 값입니다. 이 값 케이는 VT_ARRAY VT_UI1(원시 바이트), VT_BSTR|(문자열), VT_UI4(정수) 또는 VT_BOOL(부울)의 VARIANT 형식 중 하나입니다 .

반환 값

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

반환 코드/값 설명
S_OK
0
 작업이 완료되었습니다.
E_INVALIDARG
0x80000003
 configurationKey 매개 변수가 NULL이거나 비어 있거나 configurationValue 매개 변수가 유효한 변형 형식이 아닙니다.
VM_E_VM_UNKNOWN
0xA0040207
 구성을 알 수 없습니다.
DISP_E_EXCEPTION
0x80020009
 예기치 않은 오류가 발생했습니다.

설명

configurationKey 매개 변수에 대해 다음 값이 지원됩니다.

configurationKey 값 Description 데이터 형식 기본값
"하드웨어/바이오스/time_sync_at_boot"
 VM CMOS 클록이 부팅 시 호스트 클록과 동기화될 경우 "true"입니다. 그렇지 않으면 "false"입니다.
 "boolean"
 "true"
"integration/microsoft/host_time_sync/enabled""
 통합 구성 요소에서 호스트 시간 동기화를 사용하도록 설정하면 "true"이고, 그렇지 않으면 "false"입니다.
 "boolean"
 "true"
"ui_options/auto_app_publish"
 통합 구성 요소에서 애플리케이션의 자동 게시를 사용하도록 설정하면 "true"이고, 그렇지 않으면 "false"입니다. 이를 가상 애플리케이션이라고도 합니다.
 "boolean"
 "true"
"ui_options/seconds_to_save"
 모든 애플리케이션이 닫힌 후 VM을 저장하기 전에 대기할 시간(초)입니다. 그러나 20 미만의 값과 4,294,968보다 큰 값은 특별한 의미를 갖습니다. 자세한 내용은 다음 목록을 참조하세요.
0
VM을 저장하지 마세요.
1 20
VM을 저장하기 전에 20초 정도 기다립니다.
21 4,294,967
VM을 저장하기 전에 지정된 시간(초)을 기다립니다.
4,294,968 4,294,967,295
VM을 저장하기 전에 4,294,968초를 기다립니다.
 "정수"
 300

이 메서드는 모든 구성 값에 대한 낮은 수준의 액세스를 제공합니다. 고객 정의 키에 대한 구성 값을 설정하는 데 사용할 수 있습니다. 구성 값에 대해 오류 검사가 수행되지 않으므로 이 메서드를 사용하여 시스템 구성 값을 설정하는 경우 주의해야 합니다. 또한 가상 머신이 실행되는 동안에는 일부 구성 값을 변경할 수 없습니다.

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

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

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

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

"hardware/memory/ram_size"

원하는 트리의 키에 "id" 특성 값이 있는 경우 특성과 해당 값은 연결된 구성 키 바로 뒤의 configurationKey 경로 문자열에 포함됩니다. "[@id="id_value"]".

예를 들어 다음 키 트리에 있는 "golf" 키의 값을 설정하려면 다음을 수행합니다.

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

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

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

요구 사항

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

추가 정보

IVMVirtualMachine

IVMVirtualPC::SetConfigurationValue