IVMVirtualPC::SetConfigurationValue 메서드
[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
지정된 구성 설정의 값을 설정합니다.
구문
HRESULT SetConfigurationValue(
[in] BSTR preferenceKey,
[in] VARIANT preferenceValue
);
매개 변수
-
preferenceKey [in]
-
사용자별 구성 파일("%LocalAppData%\Microsoft\Windows Virtual PC"의 Options.xml)에 저장된 기본 설정을 식별하는 데 사용되는 키입니다.
중요
SetConfigurationValue 메서드만 사용하여 Options.xml 변경해야 합니다. 다른 메서드를 사용하여 Options.xml 변경하는 것은 지원되지 않습니다.
-
preferenceValue [in]
-
기본 설정 값입니다. 이 값은 VT_ARRAY VT_UI1(원시 바이트), VT_BSTR|(문자열), VT_UI4(정수) 또는 VT_BOOL(부울) 형식 중 하나일 수 있습니다 .
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
preferenceKey 또는 preferenceValue 매개 변수는 NULL입니다. |
|
preferenceKey 매개 변수가 잘못되거나 빈 문자열입니다. |
|
예기치 않은 오류가 발생했습니다. |
|
현재 사용자에게 구성 파일에 대한 액세스 권한이 부족합니다. |
|
프로세서는 HAV(하드웨어 가속 가상화) 확장을 지원하지 않습니다. |
설명
preferenceKey 매개 변수에 대해 다음 값이 지원됩니다.
| preferenceKey 값 | 설명 | 데이터 형식 | 기본값 |
|---|---|---|---|
| "idle_timeout" |
Windows Virtual PC 인터페이스를 사용하는 활성 VM 또는 애플리케이션이 없는 경우 종료하기 전에 vpc.exe 기다려야 하는 시간(초)입니다. |
"정수" |
"30" |
이 메서드는 모든 구성 값에 대한 낮은 수준의 액세스를 제공합니다. 고객 정의 키에 대한 구성 값을 설정하는 데 사용할 수 있습니다. 구성 값에 대해 오류 검사가 수행되지 않으므로 이 메서드를 사용하여 시스템 구성 값을 설정하는 경우 주의해야 합니다. 또한 가상 머신이 실행되는 동안에는 일부 구성 값을 변경할 수 없습니다.
구성 키는 가상 머신의 "Options.xml" 파일에 XML 형식으로 있습니다. 키는 Windows의 레지스트리 키와 유사한 계층적 방식으로 저장됩니다. 특정 하위 키를 지정하기 위해 슬래시 표시로 구분된 형식의 다양한 키를 지정하는 "키 경로"가 생성됩니다.
예를 들어 다음 키 트리에 있는 "idle_timeout" 키의 값을 설정하려면 다음을 수행합니다.
<preferences>
<idle_timeout type="integer">60</idle_timeout>
preferenceKey 경로 문자열은 다음과 같이 지정됩니다.
"idle_timeout"
원하는 트리의 키에 "id" 특성 값이 있는 경우 특성과 해당 값은 연결된 구성 키 바로 뒤의 preferenceKey 경로 문자열에 포함됩니다. "[@id="id_value"]" 대괄호로 묶인 형식을 사용합니다.
예를 들어 다음 키 트리에 있는 "golf" 키의 값을 설정하려면 다음을 수행합니다.
<preferences>
<alpha>
<bravo>
<charlie>
<delta id="1">
<echo id="0">
<foxtrot>
<golf type="string">D</golf>
preferenceKey 경로 문자열은 다음과 같이 지정됩니다.
"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 클라이언트 지원 종료 |
Windows 7 |
| 제품 |
Windows Virtual PC |
| 헤더 |
|
| IID |
IID_IVMVirtualPC 236ba0d9-a24a-4292-a132-27c1421dfd01로 정의됩니다. |