FILE_LINKS_INFORMATION-Struktur (ntifs.h)

Die FILE_LINKS_INFORMATION-Struktur wird verwendet, um researchNTFS-Feste Links zu einer vorhandenen Datei abzufragen oder festzulegen.

Syntax

typedef struct _FILE_LINKS_INFORMATION {
  ULONG                       BytesNeeded;
  ULONG                       EntriesReturned;
  FILE_LINK_ENTRY_INFORMATION Entry;
} FILE_LINKS_INFORMATION, *PFILE_LINKS_INFORMATION;

Member

BytesNeeded

Die Anzahl der Bytes, die erforderlich sind, um alle verfügbaren Namen zu enthalten, die in Entry zurückgegeben werden. Dieser Wert muss größer als 0 sein.

EntriesReturned

Die Anzahl der FILE_LINK_ENTRY_INFORMATION Strukturen, die mithilfe des Entry-Elements zurückgegeben wurden.

Entry

Ein Puffer, der die zurückgegebenen FILE_LINK_ENTRY_INFORMATION-Strukturen enthält.

Hinweise

Wenn EntriesReturned den Wert 0 aufweist, ist nicht genügend Arbeitsspeicher verfügbar, um einen Eintrag zurückzugeben. Der Fehler STATUS_BUFFER_OVERFLOW (0x80000005) gibt an, dass nicht alle verfügbaren Einträge zurückgegeben wurden.

Eintrag ist die erste FILE_LINK_ENTRY_INFORMATION Struktur in einer Liste von Einträgen. Wenn das NextEntryOffset-Feld eines Eintrags den Wert 0 aufweist, wurden keine weiteren Einträge zurückgegeben. Andernfalls befindet sich der nächste zurückgegebene Eintrag NextEntryOffset Bytes aus dem vorherigen Eintrag.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Kopfzeile ntifs.h (include FltKernel.h, Ntifs.h)

Weitere Informationen

FILE_LINK_ENTRY_INFORMATION