영어로 읽기

다음을 통해 공유


IVMHardDisk::MergeTo 메서드

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

차이점이 있는 가상 하드 디스크를 모든 부모(루트 부모 가상 하드 디스크 포함)와 새 하드 디스크 파일에 병합합니다.

구문

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

매개 변수

newDiskImagePath [in]

선택한 디스크 이미지가 병합될 새 대상 디스크 이미지의 경로입니다.

newDiskImageType [in]

새 대상 디스크 이미지의 유형입니다. 새 대상 디스크 이미지에 허용되는 이미지 유형은 vmDiskType_DynamicvmDiskType_FixedSize. 자세한 내용은 VMHardDiskType을 참조하세요.

mergeTask [out, retval]

병합 프로세스의 완료를 추적하는 데 사용되는 IVMTask 개체입니다.

반환 값

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

반환 코드/값 Description
S_OK
0
작업이 완료되었습니다.
E_POINTER
0x80004003
매개 변수는 NULL입니다.
E_INVALIDARG
0x80000003
newDiskImagePath 매개 변수가 비어 있습니다.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
시스템에서 newDiskImagePath 매개 변수로 지정된 파일을 찾을 수 없습니다.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
시스템에서 newDiskImagePath 매개 변수로 지정된 경로를 찾을 수 없습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
newDiskImagePath 매개 변수에 잘못된 문자가 포함되어 있습니다(다음 중 하나: "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
newDiskImagePath 매개 변수는 빈 경로 또는 상대 경로를 지정합니다. 절대 경로가 필요합니다.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
newDiskImagePath 매개 변수로 지정된 경로가 너무 깁니다. 경로는 260자 미만이어야 합니다.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
이 개체에서 참조하는 가상 하드 디스크가 사용 중이거나 이 가상 하드 디스크의 부모가 사용 중입니다.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
이 오류는 이 IVMHardDisk 개체에서 참조하는 가상 하드 디스크 이미지가 다른 디스크 이미지가 아니거나 newDiskImageType 매개 변수가 허용되는 값 중 하나가 아니므로 vmDiskType_Dynamic 또는 vmDiskType_FixedSize 발생합니다.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
newDiskImagePath 매개 변수에서 참조하는 파일이 이미 있습니다.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
호스트 볼륨에 이 가상 하드 디스크를 병합할 공간이 부족합니다.
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
이 개체에서 참조하는 가상 하드 디스크의 부모가 없습니다.
VM_E_APP_SHUTTING_DOWN
0xA0040209
애플리케이션이 종료되어 가상 하드 디스크 이미지를 병합할 수 없습니다.
DISP_E_EXCEPTION
0x80020009
예기치 않은 오류가 발생했습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버
지원되는 버전 없음
클라이언트 지원 종료
Windows 7
제품
Windows Virtual PC
헤더
VPCCOMInterfaces.h
IID
IID_IVMHardDisk ffa14ae6-48f5-42a4-8a22-186f2e5c7db0으로 정의됩니다.

추가 정보

IVMHardDisk