FILE_NOTIFY_EXTENDED_INFORMATION-Struktur (winnt.h)

Artikel
03/06/2024

Beschreibt die von der ReadDirectoryChangesExW-Funktion gefundenen Änderungen.

Syntax

typedef struct _FILE_NOTIFY_EXTENDED_INFORMATION {
  DWORD         NextEntryOffset;
  DWORD         Action;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastModificationTime;
  LARGE_INTEGER LastChangeTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER AllocatedLength;
  LARGE_INTEGER FileSize;
  DWORD         FileAttributes;
  union {
    DWORD ReparsePointTag;
    DWORD EaSize;
  } DUMMYUNIONNAME;
  LARGE_INTEGER FileId;
  LARGE_INTEGER ParentFileId;
  DWORD         FileNameLength;
  WCHAR         FileName[1];
} FILE_NOTIFY_EXTENDED_INFORMATION, *PFILE_NOTIFY_EXTENDED_INFORMATION;

Member

NextEntryOffset

Die Anzahl der Bytes, die übersprungen werden müssen, um zum nächsten Datensatz zu gelangen. Der Wert 0 gibt an, dass dies der letzte Datensatz ist.

Action

Der Typ der Änderung, die aufgetreten ist. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
FILE_ACTION_ADDED 0x00000001	Die Datei wurde dem Verzeichnis hinzugefügt.
FILE_ACTION_REMOVED 0x00000002	Die Datei wurde aus dem Verzeichnis entfernt.
FILE_ACTION_MODIFIED 0x00000003	Die Datei wurde geändert. Dies kann eine Änderung des Zeitstempels oder der Attribute sein.
FILE_ACTION_RENAMED_OLD_NAME 0x00000004	Die Datei wurde umbenannt, und dies ist der alte Name.
FILE_ACTION_RENAMED_NEW_NAME 0x00000005	Die Datei wurde umbenannt, und dies ist der neue Name.

CreationTime

Das Datum und die Uhrzeit, zu der das Verzeichnis oder die Datei erstellt und dem Dateisystem hinzugefügt wurde.

LastModificationTime

Das Datum und die Uhrzeit der letzten Änderung des Inhalts des Verzeichnisses oder der Datei im Dateisystem.

LastChangeTime

Das Datum und die Uhrzeit der letzten Änderung der Metadaten oder des Inhalts des Verzeichnisses oder der Datei im Dateisystem.

LastAccessTime

Das Datum und die Uhrzeit des letzten Zugriffs auf das Verzeichnis oder die Datei im Dateisystem.

AllocatedLength

Die zugeordnete Größe der Datei in Bytes.

FileSize

Die neue Größe des Verzeichnisses oder der Datei in Bytes oder die alte Größe, wenn die Größe unverändert ist.

FileAttributes

Die Attribute des Verzeichnisses oder der Datei.

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparsePointTag

DUMMYUNIONNAME.EaSize

FileId

Der Bezeichner des Verzeichnisses oder der Datei.

ParentFileId

Der Bezeichner des übergeordneten Verzeichnisses für die Datei.

FileNameLength

Die Größe des Dateinamenteils des Datensatzes in Bytes. Dieser Wert enthält kein beendendes NULL-Zeichen.

FileName[1]

Ein Feld mit variabler Länge, das den Dateinamen relativ zum Verzeichnishandle enthält. Der Dateiname hat das Unicode-Zeichenformat und ist nicht null-beendet.

Wenn sowohl ein kurzer als auch ein langer Name für die Datei vorhanden ist, gibt die Funktion einen dieser Namen zurück, aber es ist nicht angegeben, welcher Name.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	winnt.h (Einschließen von Windows.h)

Weitere Informationen

ReadDirectoryChangesExW

Share via