structure REPARSE_GUID_DATA_BUFFER (ntifs.h)

Article
12/21/2024

La structure REPARSE_GUID_DATA_BUFFER contient des données de point d’analyse pour un point d’analyse.

Syntaxe

typedef struct _REPARSE_GUID_DATA_BUFFER {
  ULONG  ReparseTag;
  USHORT ReparseDataLength;
  USHORT Reserved;
  GUID   ReparseGuid;
  struct {
    UCHAR DataBuffer[1];
  } GenericReparseBuffer;
} REPARSE_GUID_DATA_BUFFER, *PREPARSE_GUID_DATA_BUFFER;

Membres

ReparseTag

Balise de point d’analyse qui identifie de façon unique le propriétaire du point d’analyse. (Consultez la section remarques suivante.)

ReparseDataLength

Taille, en octets, des données d’analyse dans le membre DataBuffer.

Reserved

Réservé; n’utilisez pas.

ReparseGuid

GUID qui identifie de façon unique le propriétaire du point d’analyse. (Consultez la section remarques suivante.)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Données définies par l’utilisateur pour le point d’analyse. Le format de ces données est défini par le propriétaire du point d’analyse.

Remarques

La structure REPARSE_GUID_DATA_BUFFER est utilisée par tous les systèmes de fichiers, filtres et mini-filtres tiers, ainsi que certains systèmes de fichiers, filtres et mini-filtres Microsoft pour stocker des données pour un point d’analyse. Chaque point d’analyse contient une structure REPARSE_GUID_DATA_BUFFER.

Les points d’analyse Microsoft peuvent utiliser la structure REPARSE_DATA_BUFFER au lieu de la structure REPARSE_GUID_DATA_BUFFER. Toutefois, des points d’analyse tiers sont nécessaires pour utiliser la structure REPARSE_GUID_DATA_BUFFER.

Les balises de point d’analyse sont affectées à des tiers par Microsoft. Vous pouvez demander plusieurs points d’analyse à utiliser avec un système de fichiers, un pilote de filtre de système de fichiers ou un pilote minifilter.

Les GUID de point d’analyse ne sont pas attribués par Microsoft. Toutefois, vous devez choisir un GUID à utiliser avec votre balise de point d’analyse affectée, et vous devez toujours utiliser ce GUID avec la balise. Pour générer un GUID, vous pouvez utiliser GUIDGen (Guidgen.exe), un outil inclus dans le Kit de développement logiciel (SDK) Microsoft Windows.

Les minifilters peuvent définir ou supprimer un point d’analyse en appelant FltTagFile ou FltUntagFile. Les minifiltres peuvent récupérer un point d’analyse à l’aide du code de contrôle FSCTL_GET_REPARSE_POINT. Ce code peut être envoyé au système de fichiers en appelant FltFsControlFile.

Les systèmes de fichiers et les pilotes de filtre peuvent récupérer, définir ou supprimer un point d’analyse à l’aide des codes de contrôle FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINTet FSCTL_DELETE_REPARSE_POINT. Ces codes peuvent être envoyés au système de fichiers en appelant ZwFsControlFile.

Pour plus d’informations sur les points d’analyse et les balises de point d’analyse, consultez la documentation du Kit de développement logiciel (SDK) Windows.