FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

  • Artículo

Desbloquea un volumen.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,            // handle to a volume
  FSCTL_UNLOCK_VOLUME,         // dwIoControlCode
  NULL,                        // lpInBuffer
  0,                           // nInBufferSize
  NULL,                        // lpOutBuffer
  0,                           // nOutBufferSize
  (LPDWORD) lpBytesReturned,   // number of bytes returned
  (LPOVERLAPPED) lpOverlapped  // OVERLAPPED structure
);

Irp-IoStatus.Status> se establece en STATUS_SUCCESS si la solicitud se realiza correctamente.

De lo contrario, estado de la condición de error adecuada como código NTSTATUS.

Para obtener más información, vea Valores NTSTATUS.

Comentarios

Para bloquear un volumen, use el código de control FSCTL_LOCK_VOLUME .

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

\.\X:

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

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

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Ver comentario
 

La notificación PNP solo se emite en el nodo donde se emitió el FSCTL.

Después de adquirir un bloqueo en un volumen CSV, debe cerrar el identificador usado para bloquear ese volumen antes de abrir un identificador en el volumen. Desbloquear el volumen mediante FSCTL_UNLOCK_VOLUME no es suficiente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluya Windows.h)

Consulte también

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

Códigos de control de administración del volumen