структура REPARSE_GUID_DATA_BUFFER (ntifs.h)

Статья
12/21/2024

Структура REPARSE_GUID_DATA_BUFFER содержит данные точки повторного анализа для точки повторного анализа.

Синтаксис

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;

Члены

ReparseTag

Тег точки reparse, который однозначно идентифицирует владельца точки повторного параметров. (См. следующий раздел Примечания.)

ReparseDataLength

Размер в байтах данных повторного анализа в элементе DataBuffer.

Reserved

Скрытный; не используйте.

ReparseGuid

ИДЕНТИФИКАТОР GUID, который однозначно идентифицирует владельца точки повторного использования. (См. следующий раздел Примечания.)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Определяемые пользователем данные для точки повторного анализа. Формат этих данных определяется владельцем точки повторного анализа.

Замечания

Структура REPARSE_GUID_DATA_BUFFER используется всеми сторонними файловыми системами, фильтрами и минифильтрами, а также некоторыми файловыми системами Майкрософт, фильтрами и минифильтрами для хранения данных для точки повторного анализа. Каждая точка перепарса содержит одну REPARSE_GUID_DATA_BUFFER структуру.

Точки повторного анализа Майкрософт могут использовать REPARSE_DATA_BUFFER структуру вместо структуры REPARSE_GUID_DATA_BUFFER. Однако сторонние точки повторного анализа необходимы для использования REPARSE_GUID_DATA_BUFFER структуры.

Теги точек reparse назначены сторонним. Вы можете запросить несколько точек повторного анализа для использования с файловой системой, драйвером фильтра файловой системы или драйвером мини-фильтра.

Идентификаторы GUID точки повторной аналитики не назначаются корпорацией Майкрософт. Однако необходимо выбрать один GUID для использования с назначенным тегом точки повторного использования, и этот GUID всегда должен использоваться с тегом. Чтобы создать GUID, можно использовать GUIDGen (Guidgen.exe), инструмент, включенный в пакет SDK для Microsoft Windows.

Минифильтры могут задавать или удалять точку повторного анализа, вызывая FltTagFile или FltUntagFile. Минифильтры могут получить точку повторного анализа с помощью кода элемента управления FSCTL_GET_REPARSE_POINT. Этот код можно отправить в файловую систему, вызвав FltFsControlFile.

Файловые системы и драйверы фильтров могут получать, задавать или удалять точку повторного просмотра с помощью кодов управления FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINTи FSCTL_DELETE_REPARSE_POINT. Эти коды можно отправлять в файловую систему, вызывая ZwFsControlFile.

Дополнительные сведения о точках повторного анализа и тегах точек повторного анализа см. в документации по пакету SDK для Windows.