ExpandVirtualDisk 함수(virtdisk.h)

고정되거나 동적으로 확장 가능한 VHD(가상 하드 디스크)의 크기를 늘입니다.

구문

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

매개 변수

[in] VirtualDiskHandle

VIRTUAL_DISK_ACCESS_METAOPS 플래그를 사용하여 열어야 하는 열려 있는 가상 디스크에 대한 핸들입니다. 가상 디스크를 여는 방법에 대한 자세한 내용은 OpenVirtualDisk 함수를 참조하세요.

[in] Flags

EXPAND_VIRTUAL_DISK_FLAG 열거형의 EXPAND_VIRTUAL_DISK_FLAG_NONE 값이어야 합니다.

[in] Parameters

확장 매개 변수 데이터를 포함하는 유효한 EXPAND_VIRTUAL_DISK_PARAMETERS 구조체에 대한 포인터입니다.

[in, optional] Overlapped

비동기 작업이 필요한 경우 유효한 OVERLAPPED 구조체에 대한 선택적 포인터입니다.

반환 값

요청의 상태입니다.

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 오류 코드입니다. 자세한 내용은 시스템 오류 코드를 참조하세요.

설명

ExpandVirtualDisk 함수는 현재 위치에서 작업을 수행하므로 가상 디스크를 만들지 않습니다.

확장 작업은 고정 및 확장 가능한 가상 디스크에만 유효하며 차이점이 있는 가상 디스크 체인을 무효화합니다.

가상 디스크를 확장하려면 작업 중에 가상 디스크를 분리해야 합니다.

호출자에게 READ| 가 있어야 합니다.가상 디스크의 백업 저장소에 대한 WRITE 액세스 권한입니다.

확장 가능한 가상 디스크의 경우 ExpandVirtualDisk 함수는 크기가 가상이며 실제로 사용될 때까지 물리적으로 증가하지 않기 때문에 더 큰 파일을 생성하지 않을 수 있습니다.

가상 디스크를 확장할 수 있고 호스트 볼륨에 새 크기에 충분한 공간이 없는 경우 ExpandVirtualDisk 함수는 어쨌든 성공할 수 있습니다. 가상 디스크가 확장될 때 호스트 볼륨의 공간이 부족하면 가상 디스크에 대한 향후 쓰기가 실패할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	virtdisk.h
라이브러리	VirtDisk.lib
DLL	VirtDisk.dll

추가 정보

VHD 정보

VHD 참조