Compartir a través de


FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

Desbloquea un volumen.

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

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, status to the appropriate error condition as a NTSTATUS code.

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

Observaciones

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

El identificador de hDevice pasado a DeviceIoControl debe ser un identificador de 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 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.

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

Tecnología Soportado
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 al volumen. Desbloquear el volumen mediante FSCTL_UNLOCK_VOLUME no es suficiente.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de winioctl.h (incluya Windows.h)

Consulte también

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

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