FSCTL_REQUEST_OPLOCK_LEVEL_2 IOCTL (winioctl.h)

  • Artigo

Solicita um bloqueio oportunista de nível 2 em um arquivo.

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

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

Comentários

Essa operação é usada apenas por aplicativos cliente que solicitam um bloqueio oportunista de um servidor local. Os aplicativos cliente que solicitam bloqueios oportunistas de servidores remotos não devem solicitá-los diretamente— o redirecionador de rede solicita de forma transparente bloqueios oportunistas para o aplicativo. Uma tentativa de usar essa operação para solicitar bloqueios oportunistas de servidores remotos resultará na negação da solicitação.

Se um novo tipo oplock for desejado, o identificador deverá ser fechado e um novo identificador reaberto usando CreateFile e DeviceIoControl deverá ser chamado no novo identificador com o código de controle FSCTL_REQUEST_OPLOCK_XXX desejado. Para solicitar um oplock em um identificador que possa ter o tipo oplock alterado no local (o identificador não precisa ser fechado e reaberto), use o código de controle FSCTL_REQUEST_OPLOCK .

Use FSCTL_REQUEST_OPLOCK_LEVEL_2 para solicitar um bloqueio oportunista de nível 2 em um arquivo. Um sistema de arquivos cliente pode armazenar em cache dados de leitura (mas não gravar dados) localmente, desde que o bloqueio de nível 2 seja mantido.

O sistema de arquivos não requer nenhuma confirmação do aplicativo que solicitou o bloqueio oportunista de nível 2 quando o bloqueio é quebrado. Depois que o bloqueio é interrompido, o redirecionador de rede é notificado para não considerar como válidos os dados armazenados em cache do arquivo. Para obter mais informações, consulte Breaking Oplocks.

Para obter mais informações, consulte Tipos de bloqueios oportunistas.

Para obter uma comparação dos vários códigos de controle oplock, consulte FSCTL_REQUEST_OPLOCK.

Um código de controle FSCTL_REQUEST_OPLOCK_LEVEL_2 falhará se o arquivo for aberto no modo não sobreposto (síncrono).

Para obter as implicações de E/S sobrepostas nessa operação, consulte a seção Comentários do tópico DeviceIoControl .

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

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 No
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim

Requisitos

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

Confira também