FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

  • Artigo

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.

Tecnologia Suportado
Protocolo SMB (Bloco de Mensagens do Servidor) 3.0 Não
TFO (Failover Transparente) do SMB 3.0 Não
SMB 3.0 com Compartilhamentos de Arquivos de Expansão (SO) Não
Sistema de Arquivos de Volume Compartilhado de Cluster (CsvFS) Consulte o comentário
 

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

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho winioctl.h (inclua Windows.h)

Consulte também

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

códigos de controle de gerenciamento de volume