FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • 發行項

擷取指定檔案或目錄的更新序號 (USN) 變更日誌資訊。

若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函式。

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // 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

備註

如果呼叫成功，則傳回 USN_RECORD_V2 或 USN_RECORD_V3 結構的成員有效，但下列成員除外： TimeStamp、 Reason 和 SourceInfo。 Usn 成員代表寫入此檔案或目錄日誌的最後一個 USN。

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

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

\.\X：

在上述字串中， X 是識別磁碟區出現所在磁碟驅動器的字母。 磁碟區必須是 ReFS 或 NTFS 3.0 或更新版本。 若要取得磁碟區的NTFS版本，請使用系統管理員訪問許可權開啟命令提示字元，然後執行下列命令：

FSUtil.exe FSInfo NTFSInfo X：

其中 X 是磁碟區的驅動器號。

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

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

規格需求

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

另請參閱

CreateFile

DeviceIoControl

USN_RECORD

磁碟區管理控制碼