structure REPARSE_GUID_DATA_BUFFER (ntifs.h)

Article
02/27/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

Répare l’étiquette de point qui identifie de manière unique le propriétaire du point d’analyse. (Voir la section Remarques suivante.)

ReparseDataLength

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

Reserved

Réservé ; ne pas utiliser.

ReparseGuid

GUID qui identifie de manière unique le propriétaire du point d’analyse. (Voir 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 minifiltres tiers, ainsi que par certains systèmes de fichiers, filtres et minifiltres 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 plutôt que 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 attribué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 de minifiltre.

Les GUID de point d’analyse ne sont pas attribués par Microsoft. Toutefois, vous devez choisir un GUID à utiliser avec l’étiquette 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 Microsoft Windows SDK.

Les minifiltres 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_POINT et 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.