REPARSE_GUID_DATA_BUFFER-Struktur (ntifs.h)

Artikel
08/07/2023

Die REPARSE_GUID_DATA_BUFFER-Struktur enthält Analysepunktdaten für einen Analysepunkt.

Syntax

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;

Member

ReparseTag

Reparse-Punkttag, das den Besitzer des Analysepunkts eindeutig identifiziert. (Weitere Informationen finden Sie im folgenden Abschnitt mit den Anmerkungen .)

ReparseDataLength

Größe der Reparsedaten im DataBuffer-Element in Bytes.

Reserved

Reserviert; nicht verwenden.

ReparseGuid

GUID, die den Besitzer des Analysepunkts eindeutig identifiziert. (Weitere Informationen finden Sie im folgenden Abschnitt mit den Anmerkungen .)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Benutzerdefinierte Daten für den Analysepunkt. Das Format dieser Daten wird vom Besitzer des Analysepunkts definiert.

Hinweise

Die REPARSE_GUID_DATA_BUFFER-Struktur wird von allen Dateisystemen, Filtern und Minifiltern von Drittanbietern sowie von einigen Microsoft-Dateisystemen, -Filtern und -Minifiltern verwendet, um Daten für einen Analysepunkt zu speichern. Jeder Analysepunkt enthält eine REPARSE_GUID_DATA_BUFFER Struktur.

Microsoft-Analysepunkte können die REPARSE_DATA_BUFFER-Struktur anstelle der REPARSE_GUID_DATA_BUFFER-Struktur verwenden. Für die Verwendung der REPARSE_GUID_DATA_BUFFER-Struktur sind jedoch Analysepunkte von Drittanbietern erforderlich.

Analysepunkttags werden von Microsoft Dritten zugewiesen. Sie können mehrere Analysepunkte für die Verwendung mit einem Dateisystem, Einem Dateisystemfiltertreiber oder Minifiltertreiber anfordern.

Analysepunkt-GUIDs werden von Microsoft nicht zugewiesen. Sie müssen jedoch eine GUID auswählen, die mit Dem zugewiesenen Analysepunkttag verwendet werden soll, und Sie müssen diese GUID immer mit dem Tag verwenden. Um eine GUID zu generieren, können Sie GUIDGen (Guidgen.exe) verwenden, ein Tool, das im Microsoft Windows SDK enthalten ist.

Minifilter können einen Analysepunkt festlegen oder löschen, indem sie FltTagFile oder FltUntagFile aufrufen. Minifilter können einen Analysepunkt mithilfe des FSCTL_GET_REPARSE_POINT-Steuerelementcodes abrufen. Dieser Code kann durch Aufrufen von FltFsControlFile an das Dateisystem gesendet werden.

Dateisysteme und Filtertreiber können einen Analysepunkt mithilfe der steuerungscodes FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINT und FSCTL_DELETE_REPARSE_POINT abrufen, festlegen oder löschen. Diese Codes können an das Dateisystem gesendet werden, indem ZwFsControlFile aufgerufen wird.

Weitere Informationen zu Analysepunkten und Analysepunkttags finden Sie in der Dokumentation zum Windows SDK.