Función ExpandVirtualDisk (virtdisk.h)
Aumenta el tamaño de un disco duro virtual (VHD) fijo o expandible dinámicamente.
Sintaxis
DWORD ExpandVirtualDisk(
[in] HANDLE VirtualDiskHandle,
[in] EXPAND_VIRTUAL_DISK_FLAG Flags,
[in] PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
[in, optional] LPOVERLAPPED Overlapped
);
Parámetros
[in] VirtualDiskHandle
Identificador del disco virtual abierto, que debe haberse abierto con la marca VIRTUAL_DISK_ACCESS_METAOPS . Para obtener información sobre cómo abrir un disco virtual, consulte la función OpenVirtualDisk .
[in] Flags
Debe ser el valor EXPAND_VIRTUAL_DISK_FLAG_NONE de la enumeración EXPAND_VIRTUAL_DISK_FLAG .
[in] Parameters
Puntero a una estructura de EXPAND_VIRTUAL_DISK_PARAMETERS válida que contiene datos de parámetros de expansión.
[in, optional] Overlapped
Puntero opcional a una estructura SUPERPUESTA válida si se desea una operación asincrónica .
Valor devuelto
Estado de la solicitud.
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error. Para obtener más información, vea Códigos de error del sistema.
Comentarios
La función ExpandVirtualDisk realiza la operación en contexto y, por tanto, no crea un disco virtual.
La operación de expansión solo es válida para discos virtuales fijos y expandibles y invalidará una cadena de discos virtuales de diferenciación.
La expansión de un disco virtual requiere que el disco virtual se desasocie durante la operación.
El autor de la llamada debe tener READ|Acceso WRITE al almacén de respaldo para el disco virtual.
En el caso de un disco virtual expandible, es posible que la función ExpandVirtualDisk no produzca un archivo mayor porque el tamaño es virtual y no crecería físicamente hasta que se use.
Si el disco virtual se puede expandir y el volumen host no tiene suficiente espacio para el nuevo tamaño, la función ExpandVirtualDisk puede realizarse correctamente de todos modos. Las escrituras futuras en el disco virtual pueden producir un error si el volumen de host se queda sin espacio a medida que se expande el disco virtual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Plataforma de destino | Windows |
| Encabezado | virtdisk.h |
| Library | VirtDisk.lib |
| Archivo DLL | VirtDisk.dll |