FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

發行項
03/13/2024

擷取兩個指定USN值之間的更新序號集 (USN) 變更記錄紀錄記錄。

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (LPVOID) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

C++

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                 (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode
                 (LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

備註

如需此作業上重疊 I/O 的影響，請參閱 DeviceIoControl 主題的一節。

有兩個 DeviceIoControl 控制代碼會傳回 USN 記錄， FSCTL_READ_USN_JOURNAL 和 FSCTL_ENUM_USN_DATA。當您想要在兩個 USN 之間列出 (列舉) USN 記錄時，請使用後者。當您想要由 USN 選取時，請使用前者。

如需詳細資訊，請參閱建立、修改和刪除變更日誌。

若要擷取磁碟區的句柄，請使用下列格式的 lpFileName 參數來呼叫 CreateFile：

\.\X：

在上述字串中， X 是識別磁碟區出現所在磁碟驅動器的字母。磁碟區必須是NTFS。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此程序代碼。

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	No
SMB 3.0 透明故障轉移 (TFO)	No
具有向外延展檔案共用的SMB 3.0 (SO)	No
叢集共用磁碟區文件系統 (CsvFS)	請參閱批注

應用程式在 CsvFs 暫停/繼續時可能會遇到誤判。

範例

如需範例，請參閱逐步執行變更緩衝區日誌記錄。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winioctl.h (包含 Windows.h)