IVMHardDisk::Convert 메서드
[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
고정 크기 가상 하드 디스크를 동적으로 확장되는 가상 하드 디스크로 변환하거나 동적으로 확장되는 가상 하드 디스크를 고정 크기의 가상 하드 디스크로 변환합니다.
구문
HRESULT Convert(
[in] BSTR convertedDiskImagePath,
[in] VMHardDiskType convertedDiskImageType,
[out, retval] IVMTask **convertTask
);
매개 변수
-
convertedDiskImagePath [in]
-
대상 디스크 이미지 파일의 경로입니다.
-
convertedDiskImageType [in]
-
대상 디스크 이미지의 형식입니다. 값 목록은 VMHardDiskType을 참조하세요.
-
convertTask [out, retval]
-
변환 프로세스의 완료를 추적하는 데 사용되는 IVMTask 개체입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
convertedDiskImagePath 매개 변수가 비어 있거나 파일 이름에 .vhd 확장명이 없습니다. |
|
매개 변수는 NULL입니다. |
|
시스템에서 convertedDiskImagePath 매개 변수로 지정된 경로를 찾을 수 없습니다. |
|
convertedDiskImagePath 매개 변수에 잘못된 문자("*?<> /|":"). |
|
convertedDiskImagePath 매개 변수는 빈 경로 또는 상대 경로를 지정합니다. 절대 경로가 필요합니다. |
|
convertedDiskImagePath 매개 변수로 지정된 경로가 너무 깁니다. 경로는 MAX_PATH (260) 문자 미만이어야 합니다. |
|
이 개체에서 참조하는 가상 하드 디스크가 사용 중이거나 이 가상 하드 디스크의 부모가 사용 중입니다. |
|
호스트 볼륨에 이 가상 하드 디스크를 변환할 공간이 부족합니다. |
|
convertedDiskImagePath 매개 변수에서 참조하는 파일이 이미 있습니다. |
|
convertedDiskImagePath 매개 변수는 vmDiskType_Dynamic 또는 vmDiskType_FixedSize 합니다. |
|
이 IVMHardDisk 개체에서 참조하는 가상 하드 디스크 이미지는 유효한 이미지가 아닌 것 같습니다. |
|
이 개체에서 참조하는 가상 하드 디스크의 부모가 없습니다. |
|
애플리케이션이 종료되어 가상 하드 디스크 이미지를 변환할 수 없습니다. |
|
예기치 않은 오류가 발생했습니다. |
설명
원본 파일은 변환 프로세스 후에 그대로 유지됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 클라이언트 지원 종료 |
Windows 7 |
| 제품 |
Windows Virtual PC |
| 헤더 |
|
| IID |
IID_IVMHardDisk ffa14ae6-48f5-42a4-8a22-186f2e5c7db0으로 정의됩니다. |