FILE_NOTIFY_INFORMATION結構 (winnt.h)

描述 ReadDirectoryChangesW 函式所找到的變更。

語法

typedef struct _FILE_NOTIFY_INFORMATION {
  DWORD NextEntryOffset;
  DWORD Action;
  DWORD FileNameLength;
  WCHAR FileName[1];
} FILE_NOTIFY_INFORMATION, *PFILE_NOTIFY_INFORMATION;

成員

NextEntryOffset

必須略過的位元組數目，才能進入下一筆記錄。 值為零表示這是最後一筆記錄。

Action

已發生的變更類型。 這個成員可以是下列其中一個值。

值	意義
FILE_ACTION_ADDED 0x00000001	檔案已新增至 目錄。
FILE_ACTION_REMOVED 0x00000002	檔案已從目錄中移除。
FILE_ACTION_MODIFIED 0x00000003	檔案已修改。 這可以是時間戳或屬性的變更。
FILE_ACTION_RENAMED_OLD_NAME 0x00000004	檔案已重新命名，這是舊的名稱。
FILE_ACTION_RENAMED_NEW_NAME 0x00000005	檔案已重新命名，這是新的名稱。

FileNameLength

記錄的檔名部分大小，以位元組為單位。 請注意，這個值不包含終止 Null 字元。

FileName[1]

可變長度欄位，包含相對於目錄句柄的檔名。 檔名是 Unicode 字元格式，不是以 Null 結尾。

如果檔案有簡短和長名稱，函式會傳回其中一個名稱，但未指定哪一個名稱。

規格需求

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

另請參閱

ReadDirectoryChangesW