FILE_STREAM_INFO structure (winbase.h)

Receives file stream information for the specified file. Used for any handles. Use only when calling GetFileInformationByHandleEx.

Syntax

typedef struct _FILE_STREAM_INFO {
  DWORD         NextEntryOffset;
  DWORD         StreamNameLength;
  LARGE_INTEGER StreamSize;
  LARGE_INTEGER StreamAllocationSize;
  WCHAR         StreamName[1];
} FILE_STREAM_INFO, *PFILE_STREAM_INFO;

Members

NextEntryOffset

The offset for the next FILE_STREAM_INFO entry that is returned. This member is zero if no other entries follow this one.

StreamNameLength

The length, in bytes, of StreamName.

StreamSize

The size, in bytes, of the data stream.

StreamAllocationSize

The amount of space that is allocated for the stream, in bytes. This value is usually a multiple of the sector or cluster size of the underlying physical device.

StreamName[1]

The stream name.

Remarks

The FILE_STREAM_INFO structure is used to enumerate the streams for a file.

Support for named data streams is file-system-specific.

The FILE_STREAM_INFO structure must be aligned on a LONGLONG (8-byte) boundary. If a buffer contains two or more of these structures, the NextEntryOffset value in each entry, except the last, falls on an 8-byte boundary.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps | UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps | UWP apps]
Header	winbase.h (include Windows.h)
Redistributable	Windows SDK on Windows Server 2003 and Windows XP.

See also

FILE_INFO_BY_HANDLE_CLASS

GetFileInformationByHandleEx