Método IVdsVolume::D elete (vds.h)
[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]
Elimina el volumen y todos los plexos, liberando las extensiones.
Sintaxis
HRESULT Delete(
[in] BOOL bForce
);
Parámetros
[in] bForce
Si es TRUE, VDS elimina el volumen aunque esté en uso; de lo contrario, el volumen no se elimina si está en uso.
Valor devuelto
Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
Los plexos se eliminaron correctamente. |
Comentarios
Solo puede eliminar volúmenes de un paquete en línea. Use el método IVdsPack::GetProperties para confirmar que el estado del paquete es VDS_PS_ONLINE.
No se puede eliminar un volumen que se encuentra en medios extraíbles.
VDS desmonta el sistema de archivos antes de eliminar un volumen, una operación requerida por FAT y FAT32, pero no NTFS. Además, VDS elimina todas las rutas de acceso al volumen después de eliminar el propio volumen. Si se produce un error en la operación de desmontaje y bForce es true, VDS elimina el volumen sin desmontaje. Las aplicaciones cliente del sistema de archivos deben controlar esta situación. Si el desmontaje se realiza correctamente y se produce un error en la operación de eliminación, VDS intenta volver a montar el volumen.
VDS evita la eliminación del sistema actual y los volúmenes de arranque, así como el archivo de páginas, crashdump y volúmenes hibernate. Puede mover o restablecer el archivo crashdump y pagefile. El volumen de hibernación debe permanecer en la partición de arranque.
Windows Server 2003: Los volúmenes crashdump e hibernate deben permanecer en la partición de arranque.
Windows Server 2003: Una vez eliminado el volumen, VDS intenta eliminar las carpetas montadas. Si se produce un error, Delete devolverá VDS_S_ACCESS_PATH_NOT_DELETED, aunque el volumen se haya eliminado correctamente.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |