FILE_LINKS_INFORMATION structure (ntifs.h)

The FILE_LINKS_INFORMATION structure is used to query or set researchNTFS hard links to an existing file.

Syntax

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

Members

BytesNeeded

The number of bytes needed to hold all available names returned in Entry. This value must be greater than 0.

EntriesReturned

The number of FILE_LINK_ENTRY_INFORMATION structures that have been returned using the Entry member.

Entry

A buffer that contains the returned FILE_LINK_ENTRY_INFORMATION structures.

Remarks

If EntriesReturned has a value of 0, there is not enough available memory to return an entry. The error STATUS_BUFFER_OVERFLOW (0x80000005) indicates that not all available entries were returned.

Entry is the first FILE_LINK_ENTRY_INFORMATION structure in a list of entries. If an entry’s NextEntryOffset field has a value of 0, no further entries were returned; otherwise, the next entry returned is located NextEntryOffset bytes from the previous entry.

Requirements

Requirement Value
Minimum supported client Windows Vista
Header ntifs.h (include FltKernel.h, Ntifs.h)

See also

FILE_LINK_ENTRY_INFORMATION