FILE_NOTIFY_INFORMATION-Struktur (ntifs.h)

  • Artikel

FILE_NOTIFY_INFORMATION beschreibt die Änderungen an einem Verzeichnis. Es wird als Antwort auf eine IRP_MJ_DIRECTORY_CONTROL-Anforderung mit einem IRP_MN_NOTIFY_CHANGE_DIRECTORY Nebenfunktionscode zurückgegeben, wenn DIRECTORY_NOTIFY_INFORMATION_CLASS DirectoryNotifyInformation ist.

Syntax

typedef struct _FILE_NOTIFY_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Action;
  ULONG 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.
FILE_ACTION_ADDED_STREAM (0x00000006) Der Datei wurde ein benannter Stream hinzugefügt.
FILE_ACTION_REMOVED_STREAM (0x00000007) Ein benannter Stream wurde aus der Datei entfernt.
FILE_ACTION_MODIFIED_STREAM (0x00000008) Ein benannter Stream wurde geändert. Die Änderung kann eine Änderung der Daten oder Attribute des benannten Datenstroms sein.
FILE_ACTION_REMOVED_BY_DELETE (0x00000009) Eine Objekt-ID wurde entfernt, da die Datei, auf die die Objekt-ID verwiesen wurde, gelöscht wurde. Diese Benachrichtigung wird nur gesendet, wenn das überwachte Verzeichnis das spezielle Verzeichnis "$Extend$ObjId:$O:$INDEX_ALLOCATION" ist.
FILE_ACTION_ID_NOT_TUNNELLED (0x0000000A) Der Versuch, Objekt-ID-Informationen in eine datei zu tunneln, die erstellt oder umbenannt wird, ist fehlgeschlagen, da die Objekt-ID von einer anderen Datei auf demselben Volume verwendet wird. Diese Benachrichtigung wird nur gesendet, wenn das überwachte Verzeichnis das spezielle Verzeichnis "$Extend$ObjId:$O:$INDEX_ALLOCATION" ist.
FILE_ACTION_TUNNELLED_ID_COLLISION (0x0000000B) Ein Versuch, Objekt-ID-Informationen in eine umbenannte Datei zu tunneln, ist fehlgeschlagen, da die Datei bereits über eine Objekt-ID verfügt. Diese Benachrichtigung wird nur gesendet, wenn das überwachte Verzeichnis das spezielle Verzeichnis "$Extend$ObjId:$O:$INDEX_ALLOCATION" ist.

FileNameLength

Die Größe des Dateinamenteils des Datensatzes in Bytes. Dieser Wert enthält nicht das beendende 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, wird nur einer dieser Namen zurückgegeben, aber es ist nicht angegeben, welcher name.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Kopfzeile ntifs.h

Weitere Informationen

DIRECTORY_NOTIFY_INFORMATION_CLASS

IRP_MJ_DIRECTORY_CONTROL

ZwNotifyChangeDirectoryFileEx