REPARSE_GUID_DATA_BUFFER struttura (ntifs.h)

Articolo
02/27/2024

La struttura REPARSE_GUID_DATA_BUFFER contiene i dati del punto di riparse per un punto di ripristino.

Sintassi

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;

Members

ReparseTag

Contrassegno punto di riparse che identifica in modo univoco il proprietario del punto di ripristino. Vedere la sezione Osservazioni seguenti.

ReparseDataLength

Dimensioni, in byte, dei dati di riparse nel membro DataBuffer .

Reserved

Riservati; non usare.

ReparseGuid

GUID che identifica in modo univoco il proprietario del punto di ripristino. Vedere la sezione Osservazioni seguenti.

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Dati definiti dall'utente per il punto di ripristino. Il formato di questi dati è definito dal proprietario del punto di ripristino.

Commenti

La struttura REPARSE_GUID_DATA_BUFFER viene usata da tutti i file system, i filtri e i minifiltri di terze parti, nonché alcuni file system, filtri e minifiltri Microsoft per archiviare i dati per un punto di riparse. Ogni punto di riparse contiene una struttura REPARSE_GUID_DATA_BUFFER.

I punti di riparse Microsoft possono usare la struttura REPARSE_DATA_BUFFER anziché la struttura REPARSE_GUID_DATA_BUFFER. Tuttavia, i punti di ripristino di terze parti sono necessari per usare la struttura di REPARSE_GUID_DATA_BUFFER.

I tag dei punti di reparse vengono assegnati a terze parti da Microsoft. È possibile richiedere più punti per l'uso con un file system, un driver di filtro del file system o un driver minifilter.

I GUID dei punti di reparse non vengono assegnati da Microsoft. Tuttavia, è necessario scegliere un GUID da usare con il tag di punto reparse assegnato e è sempre necessario usare questo GUID con il tag. Per generare un GUID, è possibile usare GUIDGen (Guidgen.exe), uno strumento incluso nel Microsoft Windows SDK.

I minifilter possono impostare o eliminare un punto reparse chiamando FltTagFile o FltUntagFile. I minifilter possono recuperare un punto di riparse usando il codice di controllo FSCTL_GET_REPARSE_POINT . Questo codice può essere inviato al file system chiamando FltFsControlFile.

I file system e i driver di filtro possono recuperare, impostare o eliminare un punto di ripristino usando il FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINT e FSCTL_DELETE_REPARSE_POINT codici di controllo. Questi codici possono essere inviati al file system chiamando ZwFsControlFile.

Per altre informazioni sui punti di ripristino e sui tag dei punti di ripristino, vedere la documentazione di Windows SDK.