REPARSE_DATA_BUFFER_EX structure (ntifs.h)

La structure REPARSE_DATA_BUFFER_EX contient les données d’un point d’analyse.

Syntaxe

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;

Membres

Flags

Il peut s’agir de la valeur suivante :

Valeur de l’indicateur	Signification
REPARSE_DATA_EX_FLAG_GIVEN_TAG_OR_NONE	Force FSCTL_SET_REPARSE_POINT_EX à définir la balise d’analyse si le fichier n’a pas de balise, ou si la balise sur le fichier est identique à celle dans ExistingReparseTag. REMARQUE : Si ExistingReparseTag n’est pas une balise Microsoft, ExistingReparseGuid doit correspondre si le fichier contient déjà existingReparseTag.

ExistingReparseTag

Balise de point d’analyse sur le fichier, le cas échéant, si l’appelant souhaite également remplacer la balise d’analyse.

• Pour définir les données d’analyse avec une balise d’analyse qui peut être différente, ExistingReparseTag doit être la balise d’analyse actuelle du fichier.
• Pour mettre à jour les données d’analyse tout en conservant la même balise d’analyse, ExistingReparseTag doit être la balise d’analyse existante.
• Pour définir la balise d’analyse ainsi que les données d’analyse d’un fichier qui n’a pas encore de balise d’analyse, ExistingReparseTag doit être défini sur zéro.

ExistingReparseGuid

Pour les balises d’analyse non-Microsoft, il s’agit du GUID d’analyse existant sur le fichier, le cas échéant, lorsque l’appelant souhaite remplacer la balise et/ou le GUID d’analyse avec les données. Si ExistingReparseTag est égal à zéro, le fichier n’est pas censé avoir de balises d’analyse, de sorte que ExistingReparseGuid est ignoré. Pour les balises non-Microsoft, ExistingReparseGuid doit correspondre au GUID dans le fichier si ExistingReparseTag est différent de zéro.

Reserved

Réservé. Ne pas utiliser.

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparseDataBuffer

Structure REPARSE_DATA_BUFFER qui contient des données pour un point d’analyse défini par Microsoft.

DUMMYUNIONNAME.ReparseGuidDataBuffer

Structure REPARSE_GUID_DATA_BUFFER qui contient les données d’un point d’analyse. Les points d’analyse tiers doivent utiliser cette structure.

Remarques

La structure REPARSE_DATA_BUFFER_EX est utilisée pour stocker les données d’un point d’analyse. Utilisez REPARSE_DATA_BUFFER_EX lors de la définition d’un point d’analyse sur un fichier ou un répertoire via le FSCTL_SET_REPARSE_POINT_EX IOCTL.

Configuration requise

Condition requise	Valeur
En-tête	ntifs.h

Voir aussi

FSCTL_SET_REPARSE_POINT_EX

REPARSE_DATA_BUFFER

REPARSE_GUID_DATA_BUFFER