FILE_NAMES_INFORMATION-Struktur (ntifs.h)

  • Artikel

Eine FILE_NAMES_INFORMATION Struktur, die verwendet wird, um detaillierte Informationen über die Namen von Dateien in einem Verzeichnis abzufragen.

Syntax

typedef struct _FILE_NAMES_INFORMATION {
  ULONG NextEntryOffset;
  ULONG FileIndex;
  ULONG FileNameLength;
  WCHAR FileName[1];
} FILE_NAMES_INFORMATION, *PFILE_NAMES_INFORMATION;

Member

NextEntryOffset

Byteoffset für den nächsten FILE_NAMES_INFORMATION Eintrag, wenn mehrere Einträge in einem Puffer vorhanden sind. Dieser Member ist 0, wenn keine anderen Einträge folgen.

FileIndex

Byteoffset der Datei im übergeordneten Verzeichnis. Dieser Member ist für Dateisysteme wie NTFS nicht definiert, in denen die Position einer Datei im übergeordneten Verzeichnis nicht festgelegt ist und jederzeit geändert werden kann, um die Sortierreihenfolge beizubehalten.

FileNameLength

Länge der Dateinamenzeichenfolge.

FileName[1]

Das erste Zeichen der Dateinamenzeichenfolge. Dies wird im Arbeitsspeicher durch den Rest der Zeichenfolge gefolgt.

Hinweise

Diese Informationen können auf eine der folgenden Arten abgefragt werden:

  • Rufen Sie ZwQueryDirectoryFile auf, übergeben Sie FileNamesInformation als Wert von FileInformationClass und übergeben Sie einen aufruferseitig zugeordneten, FILE_NAMES_INFORMATION strukturierten Puffer als Wert von FileInformation.

  • Erstellen Sie eine IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL und Nebenfunktionscode IRP_MN_QUERY_DIRECTORY.

Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich.

Diese Struktur muss an einer LONG-Grenze (4 Byte) ausgerichtet werden. Wenn ein Puffer mindestens zwei dieser Strukturen enthält, fällt der NextEntryOffset-Wert in jedem Eintrag, mit Ausnahme des letzten, auf eine 4-Byte-Grenze.

Anforderungen

Anforderung Wert
Header ntifs.h (include Ntifs.h, Fltkernel.h)

Weitere Informationen

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile