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 |