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 형식 중 하나입니다 .
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 완료되었습니다. |
|
configurationKey 매개 변수가 NULL이거나 비어 있거나 configurationValue 매개 변수가 유효한 변형 형식이 아닙니다. |
|
구성을 알 수 없습니다. |
|
예기치 않은 오류가 발생했습니다. |
설명
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보다 큰 값은 특별한 의미를 갖습니다. 자세한 내용은 다음 목록을 참조하세요.
|
"정수" |
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 |
| 헤더 |
|
| IID |
IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다. |