FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

Desbloqueia um volume.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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 será definido como STATUS_SUCCESS se a solicitação for bem-sucedida.

Caso contrário, status para a condição de erro apropriada como um código NTSTATUS.

Para obter mais informações, consulte valores NTSTATUS.

Observações

Para bloquear um volume, use o código de controle FSCTL_LOCK_VOLUME.

O identificador de de hDevice passado para DeviceIoControl deve ser um identificador para um volume, aberto para acesso direto. Para recuperar esse identificador, chame CreateFile com o parâmetro lpFileName definido como uma cadeia de caracteres do seguinte formulário:

\\.\X:

em que X é uma letra de partição de disco rígido, uma unidade de disco disquete ou uma unidade de CD-ROM. O aplicativo também deve especificar os sinalizadores FILE_SHARE_READ e FILE_SHARE_WRITE no parâmetro dwShareMode de CreateFile.

No Windows 8 e no Windows Server 2012, esse código é compatível com as tecnologias a seguir.

A notificação PNP é emitida somente no nó em que o FSCTL foi emitido.

Depois de adquirir um bloqueio em um volume CSV, você deve fechar o identificador usado para bloquear esse volume antes de abrir um identificador para o volume. Desbloquear o volume usando FSCTL_UNLOCK_VOLUME não é suficiente.

Requisitos

Consulte também

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

códigos de controle de gerenciamento de volume