REPARSE_DATA_BUFFER_EX structure (ntifs.h)

The REPARSE_DATA_BUFFER_EX structure contains data for a reparse point.

Syntax

typedef struct _REPARSE_DATA_BUFFER_EX {
  ULONG     Flags;
  ULONG     ExistingReparseTag;
  GUID      ExistingReparseGuid;
  ULONGLONG Reserved;
  union {
    REPARSE_DATA_BUFFER      ReparseDataBuffer;
    REPARSE_GUID_DATA_BUFFER ReparseGuidDataBuffer;
  } DUMMYUNIONNAME;
} REPARSE_DATA_BUFFER_EX, *PREPARSE_DATA_BUFFER_EX;

Members

Flags

Can be the following value:

Flag Value Meaning
REPARSE_DATA_EX_FLAG_GIVEN_TAG_OR_NONE Forces FSCTL_SET_REPARSE_POINT_EX to set the reparse tag if the file has no tag, or if the tag on the file is same as the one in ExistingReparseTag. NOTE: If ExistingReparseTag is not a Microsoft tag, then ExistingReparseGuid should match if the file already has the ExistingReparseTag.

ExistingReparseTag

Reparse point tag on the file, if any, if the caller wants to also replace the reparse tag.

  • To set the reparse data along with a reparse tag that might be different, ExistingReparseTag should be the current reparse tag of the file.
  • To update the reparse data while maintaining the same reparse tag, ExistingReparseTag should be the existing reparse tag.
  • To set the reparse tag along with reparse data on a file that does not yet have a reparse tag, ExistingReparseTag should be set to zero.

ExistingReparseGuid

For non-Microsoft reparse tags, this is the existing reparse GUID on the file, if any, when the caller wants to replace the reparse tag and/or GUID along with the data. If ExistingReparseTag is zero, the file is not expected to have any reparse tags, so ExistingReparseGuid is ignored. For non-Microsoft tags, ExistingReparseGuid should match the GUID in the file if ExistingReparseTag is non-zero.

Reserved

Reserved. Do not use.

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparseDataBuffer

A REPARSE_DATA_BUFFER structure that contains data for a Microsoft-defined reparse point.

DUMMYUNIONNAME.ReparseGuidDataBuffer

A REPARSE_GUID_DATA_BUFFER structure that contains data for a reparse point. Third party reparse points must use this structure.

Remarks

The REPARSE_DATA_BUFFER_EX structure is used to store data for a reparse point. Use REPARSE_DATA_BUFFER_EX when setting a reparse point on a file or directory through the FSCTL_SET_REPARSE_POINT_EX IOCTL.

Requirements

Requirement Value
Header ntifs.h

See also

FSCTL_SET_REPARSE_POINT_EX

REPARSE_DATA_BUFFER

REPARSE_GUID_DATA_BUFFER