FILE_NOTIFY_INFORMATION Struktur (winnt.h)

  • Artikel

Beschreibt die von der ReadDirectoryChangesW-Funktion gefundenen Änderungen.

Syntax

typedef struct _FILE_NOTIFY_INFORMATION {
  DWORD NextEntryOffset;
  DWORD Action;
  DWORD FileNameLength;
  WCHAR FileName[1];
} FILE_NOTIFY_INFORMATION, *PFILE_NOTIFY_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.

FileNameLength

Die Größe des Dateinamenteils des Datensatzes in Bytes. Beachten Sie, dass dieser Wert das beendende NULL-Zeichen nicht enthält.

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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winnt.h (Einschließen von Windows.h)

Weitere Informationen

ReadDirectoryChangesW