FSCTL_OPLOCK_BREAK_NOTIFY IOCTL (winioctl.h)

Enables the calling application to wait for completion of an opportunistic lock break.

This operation is not useful to application developers and is documented here only for completeness. CreateFile handles the problem that this operation was designed to handle.

To perform this operation, call the DeviceIoControl function using the following parameters.

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

Remarks

This operation is used only by client applications that have requested an opportunistic lock from a local server. Client applications requesting opportunistic locks from remote servers must not request them directly—the network redirector transparently requests opportunistic locks for the application.

For the implications of overlapped I/O on this operation, see the Remarks section of the DeviceIoControl topic.

In Windows 8 and Windows Server 2012, this code is supported by the following technologies.

Requirements

See also

• CreateFile
• DeviceIoControl
• OVERLAPPED
• Oplock Semantics
• Opportunistic Locks