IVMVirtualPC::CreateVirtualMachine 메서드
[Windows 가상 PC는 Windows 8 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
새 가상 머신 구성을 만들고 가상 머신 개체를 검색합니다.
구문
HRESULT CreateVirtualMachine(
[in] BSTR configurationName,
[in] BSTR configurationPath,
[out, retval] IVMVirtualMachine **virtualMachine
);
매개 변수
-
configurationName [in]
-
만들 가상 머신의 이름입니다. 이름의 길이는 80자를 초과할 수 없으며 VMC 및 VMCX 파일에 대한 이름과 경로의 결합된 길이는 MAX_PATH (260)를 초과할 수 없습니다. 구성 파일을 만들 때 파일 이름 확장명 .vmc 및 .vmcx가 가상 머신 이름의 끝에 추가됩니다. 이 매개 변수가 NULL 이거나 빈 문자열인 경우 configurationPath 매개 변수는 VMC 파일의 전체 경로를 지정해야 합니다.
-
configurationPath [in]
-
VMC 파일을 포함할 폴더의 경로입니다. 이 폴더가 없으면 생성됩니다. configurationName이 NULL이거나 빈 문자열인 경우 새 구성 파일의 전체 경로를 지정해야 합니다.
-
virtualMachine [out, retval]
-
이 가상 머신을 나타내는 새 IVMVirtualMachine 개체에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
configurationName 또는 configurationPath 매개 변수가 잘못되거나 virtualMachine 매개 변수가 NULL입니다. |
|
시스템에서 configurationPath 매개 변수로 지정된 경로를 찾을 수 없습니다. |
|
configurationPath 매개 변수에 잘못된 문자("*?:<>/|"" 중 하나)가 포함되어 있습니다. |
|
configurationPath 매개 변수는 빈 경로 또는 상대 경로를 지정합니다. 절대 경로가 필요합니다. |
|
configurationName 및 configurationPath 매개 변수로 지정된 경로는 너무 긴 경로를 생성합니다. 경로의 총 길이는 MAX_PATH (260) 문자보다 작아야 합니다. |
|
이 이름의 구성 파일이 이 위치에 이미 있습니다. |
|
configurationName 매개 변수가 비어 있습니다. |
|
configurationName 매개 변수의 길이가 80자를 초과합니다. |
|
configurationName 매개 변수에 잘못된 문자("*?:<>/|\"" 중 하나)가 포함되어 있습니다. |
|
이 이름의 가상 머신이 이미 있습니다. |
|
프로세서는 HAV(하드웨어 가속 가상화) 확장을 지원하지 않습니다. |
|
예기치 않은 오류가 발생했습니다. |
설명
가상 머신 이름은 대/소문자를 구분하지 않습니다. 예를 들어 "MyVM" 및 "myvm"은 동일한 가상 머신을 참조합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 클라이언트 지원 종료 |
Windows 7 |
| 제품 |
Windows Virtual PC |
| 헤더 |
|
| IID |
IID_IVMVirtualPC 236ba0d9-a24a-4292-a132-27c1421dfd01로 정의됩니다. |