struttura REPARSE_GUID_DATA_BUFFER (ntifs.h)

Articolo
12/21/2024

La struttura REPARSE_GUID_DATA_BUFFER contiene i dati del punto di controllo per un punto di analisi.

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;

Membri

ReparseTag

Tag di reparse point che identifica in modo univoco il proprietario del reparse point. Vedere la sezione osservazioni seguente.

ReparseDataLength

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

Reserved

Riservato; non usare.

ReparseGuid

GUID che identifica in modo univoco il proprietario del punto di analisi. Vedere la sezione osservazioni seguente.

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

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

Osservazioni

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 analisi. Ogni reparse point contiene una struttura REPARSE_GUID_DATA_BUFFER.

I reparse points Microsoft possono usare la struttura REPARSE_DATA_BUFFER anziché la struttura REPARSE_GUID_DATA_BUFFER. Tuttavia, per usare la struttura di REPARSE_GUID_DATA_BUFFER sono necessari punti di analisi di terze parti.

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

I GUID dei punti di ripristino non vengono assegnati da Microsoft. È tuttavia necessario scegliere un GUID da usare con il tag reparse point assegnato ed è necessario usare sempre questo GUID con il tag . Per generare un GUID, è possibile usare GUIDGen (Guidgen.exe), uno strumento incluso in Microsoft Windows SDK.

I minifiltri possono impostare o eliminare un punto reparse chiamando FltTagFile o FltUntagFile. I minifiltri possono recuperare un punto reparse 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 reparse usando i codici di controllo FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINTe FSCTL_DELETE_REPARSE_POINT. Questi codici possono essere inviati al file system chiamando ZwFsControlFile.

Per altre informazioni sui reparse points e reparse point tag, vedere la documentazione di Windows SDK.