REPARSE_GUID_DATA_BUFFER Struktur (ntifs.h)

Artikel
12/21/2024

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;

Angehörige

ReparseTag

Analysepunkttag, das den Besitzer des Analysepunkts eindeutig identifiziert. (Siehe den folgenden Abschnitt "Anmerkungen".)

ReparseDataLength

Größe der Daten in Byte im DataBuffer Member.

Reserved

Reserviert; nicht verwenden.

ReparseGuid

GUID, die den Besitzer des Analysepunkts eindeutig identifiziert. (Siehe den folgenden Abschnitt "Anmerkungen".)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

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

Bemerkungen

Die REPARSE_GUID_DATA_BUFFER Struktur wird von allen Dateisystemen, Filtern und Minifiltern von Drittanbietern sowie 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 MicrosoftDritten zugewiesen. Sie können mehr als einen Analysepunkt für die Verwendung mit einem Dateisystem, dateisystemfiltertreiber oder Minifiltertreiber anfordern.

GuiDs für Analysepunkte 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 FltTagFile- oder FltUntagFile-aufgerufen wird. Minifilter können mithilfe des FSCTL_GET_REPARSE_POINT Steuerelementcodes einen Analysepunkt abrufen. Dieser Code kann an das Dateisystem gesendet werden, indem FltFsControlFileaufgerufen wird.

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

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