estructura de REPARSE_GUID_DATA_BUFFER (ntifs.h)

Artículo
08/07/2023

La estructura REPARSE_GUID_DATA_BUFFER contiene datos de punto de reanálisis para un punto de reanálisis.

Sintaxis

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;

Miembros

ReparseTag

Etiqueta de punto de reanálisis que identifica de forma única al propietario del punto de reanálisis. (Vea la siguiente sección Comentarios ).

ReparseDataLength

Tamaño, en bytes, de los datos de reanálisis en el miembro DataBuffer .

Reserved

Reservado; no usar.

ReparseGuid

GUID que identifica de forma única al propietario del punto de reanálisis. (Vea la siguiente sección Comentarios ).

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Datos definidos por el usuario para el punto de reanálisis. El formato de estos datos se define mediante el propietario del punto de reanálisis.

Comentarios

La estructura de REPARSE_GUID_DATA_BUFFER la usan todos los sistemas de archivos, filtros y minifiltros de terceros, así como algunos sistemas de archivos, filtros y minifiltros de Microsoft para almacenar datos para un punto de reanálisis. Cada punto de reanálisis contiene una estructura REPARSE_GUID_DATA_BUFFER.

Los puntos de análisis de Microsoft pueden usar la estructura REPARSE_DATA_BUFFER en lugar de la estructura de REPARSE_GUID_DATA_BUFFER. Sin embargo, se requieren puntos de reanálisis de terceros para usar la estructura de REPARSE_GUID_DATA_BUFFER.

Microsoft asigna etiquetas de punto de reanálisis a terceros. Puede solicitar más de un punto de reanálisis para su uso con un sistema de archivos, un controlador de filtro del sistema de archivos o un controlador de minifiltro.

Microsoft no asigna los GUID de punto de análisis. Sin embargo, debe elegir un GUID para usarlo con la etiqueta de punto de reanálisis asignada y siempre debe usar este GUID con la etiqueta . Para generar un GUID, puede usar GUIDGen (Guidgen.exe), una herramienta que se incluye en el Microsoft Windows SDK.

Los minifiltros pueden establecer o eliminar un punto de reanálisis llamando a FltTagFile o FltUntagFile. Los minifiltros pueden recuperar un punto de reanálisis mediante el código de control FSCTL_GET_REPARSE_POINT . Este código se puede enviar al sistema de archivos llamando a FltFsControlFile.

Los sistemas de archivos y los controladores de filtro pueden recuperar, establecer o eliminar un punto de reanálisis mediante los códigos de control de FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINT y FSCTL_DELETE_REPARSE_POINT . Estos códigos se pueden enviar al sistema de archivos llamando a ZwFsControlFile.

Para obtener más información sobre los puntos de reanálisis y las etiquetas de punto de reanálisis, consulte la documentación de Windows SDK.