FSCTL_READ_USN_JOURNAL IOCTL （winioctl.h）

發行項
06/27/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 通訊協定	不
SMB 3.0 透明故障轉移（TFO）	不
具有向外延展檔案共用的SMB 3.0（SO）	不
叢集共用磁碟區檔案系統（CsvFS）	請參閱批注

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

例子

如需範例，請參閱走變更日誌記錄的緩衝區。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winioctl.h （包括 Windows.h）