FSCTL_REQUEST_BATCH_OPLOCK IOCTL (winioctl.h)
要求檔案上的批次商機鎖定。
若要執行這項作業,請使用下列引數呼叫 DeviceIoControl 函 式。
BOOL b = DeviceIoControl(
(HANDLE) hDevice, // handle to file
FSCTL_REQUEST_BATCH_OPLOCK, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
NULL, // lpOutBuffer
0, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure
備註
只有要求從本機伺服器 (oplock (oplock) 的用戶端應用程式才會使用此作業。 從遠端伺服器要求商機鎖定的用戶端應用程式不得直接要求它們,網路重新導向器會以透明方式要求應用程式的商機鎖定。 嘗試使用此作業向遠端伺服器要求商機鎖定,將會導致要求遭到拒絕。
如果需要新的 oplock 類型,則必須關閉控制碼,並使用CreateFile重新開啟新的控制碼,而且必須在具有所需FSCTL_REQUEST_OPLOCK的新控制碼上呼叫DeviceIoControl_XXX控制項程式碼。 若要在可以就地變更 oplock 類型的控制碼上要求 oplock, (控制碼不需要關閉並重新開啟) ,請使用 FSCTL_REQUEST_OPLOCK 控制項程式碼。
使用 FSCTL_REQUEST_BATCH_OPLOCK 來要求檔案上的批次商機鎖定。 只要保留層級 1 鎖定,用戶端檔案系統就可以在本機快取讀取資料、寫入資料及處理資料。
批次 oplock 擁有者必須認可 oplock 中斷 (請參閱 中斷商機鎖定) ,才能在另一個控制碼上執行與批次 oplock 不相容的任何作業。 鎖定中斷之後,網路重新導向器會收到通知,不會將檔案中的任何快取資料視為有效。
如需詳細資訊,請參閱 Opportunistic Locks 的類型。
如需各種 oplock 控制項代碼的比較,請參閱 FSCTL_REQUEST_OPLOCK。
如果檔案以非重迭 (同步) 模式開啟, FSCTL_REQUEST_BATCH_OPLOCK控制項程式 代碼就會失敗。
如需此作業上重迭 I/O 的影響,請參閱 DeviceIoControl 主題的一節。
在 Windows 8 和 Windows Server 2012 中,下列技術支援此程式碼。
技術 | 支援 |
---|---|
伺服器訊息區 (SMB) 3.0 通訊協定 | 否 |
SMB 3.0 透明容錯移轉 (TFO) | 否 |
具有向外延展檔案共用的 SMB 3.0 (SO) | 否 |
叢集共用磁片區檔案系統 (CsvFS) | Yes |
彈性檔案系統 (ReFS) | 是 |
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | winioctl.h (包含 Windows.h) |