FSCTL_DISMOUNT_VOLUME IOCTL (winioctl.h)

Desmonta un volumen independientemente de si el volumen está en uso o no. Para obtener más información, vea la sección Comentarios.

Para realizar esta operación, llame a la función DeviceIoControl con los parámetros siguientes.

BOOL DeviceIoControl(
  (HANDLE) hDevice,            // handle to a volume
  (DWORD) FSCTL_DISMOUNT_VOLUME,   // dwIoControlCodeNULL,                        // lpInBuffer0,                           // nInBufferSizeNULL,                        // lpOutBuffer0,                           // nOutBufferSize(LPDWORD) lpBytesReturned,   // number of bytes returned
  (LPOVERLAPPED) lpOverlapped  // OVERLAPPED structure
);

Observaciones

El código de control de FSCTL_DISMOUNT_VOLUME intentará desmontar un volumen independientemente de si algún otro proceso está usando el volumen, lo que puede tener resultados impredecibles para esos procesos si no contienen un bloqueo en el volumen. Para obtener información sobre cómo bloquear un volumen, consulte FSCTL_LOCK_VOLUME.

El identificador de hDevice pasado a DeviceIoControl debe ser un identificador de un volumen, abierto para el acceso directo. Para recuperar un identificador de volumen, llame a CreateFile con el parámetro lpFileName establecido en una cadena de la forma siguiente:

\\.\X:

donde X es una letra de partición de unidad de disco duro, una unidad de disco disquete o CD-ROM unidad. La aplicación también debe especificar las marcas FILE_SHARE_READ y FILE_SHARE_WRITE en el parámetro dwShareMode de CreateFile.

Si el volumen especificado es un volumen del sistema o contiene un archivo de página, se produce un error en la operación.

Si otro proceso bloquea el volumen especificado, se produce un error en la operación. Para evitar que otro proceso bloquee el volumen, bloquee el volumen en cuanto lo abra.

Un volumen desmontado tiene las siguientes propiedades:

• No hay archivos abiertos.
• El sistema operativo detecta el volumen.

Desmontar un volumen es útil cuando un volumen necesita desaparecer durante un tiempo. Por ejemplo, una aplicación que cambia un sistema de archivos de volumen del sistema de archivos FAT al sistema de archivos NTFS podría usar el procedimiento siguiente.

Para cambiar un del sistema de archivos de volumen

1. Abra un volumen.
2. Bloquee el volumen.
3. Dar formato al volumen.
4. Desmonte el volumen.
5. Desbloquee el volumen.
6. Cierre el identificador de volumen.

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

En csvFs, el nodo donde se emite el desmontaje verá una secuencia de desmontaje normal. En todos los demás nodos FS invalidará todos los archivos abiertos.

Requisitos

Consulte también

CreateFile

DeviceIoControl

ExitThread

FSCTL_LOCK_VOLUME

GetLogicalDrives

códigos de control de administración de volúmenes