estrutura REPARSE_GUID_DATA_BUFFER (ntifs.h)

Artigo
08/07/2023

A estrutura REPARSE_GUID_DATA_BUFFER contém dados de ponto de nova análise para um ponto de nova análise.

Sintaxe

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;

Membros

ReparseTag

Reparse marca de ponto que identifica exclusivamente o proprietário do ponto de nova análise. (Consulte a seção Comentários a seguir.)

ReparseDataLength

Tamanho, em bytes, dos dados de nova análise no membro DataBuffer .

Reserved

Reservado; não use.

ReparseGuid

GUID que identifica exclusivamente o proprietário do ponto de nova análise. (Consulte a seção Comentários a seguir.)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

Dados definidos pelo usuário para o ponto de nova análise. O formato desses dados é definido pelo proprietário do ponto de nova análise.

Comentários

A estrutura REPARSE_GUID_DATA_BUFFER é usada por todos os sistemas de arquivos, filtros e minifiltros de terceiros, bem como alguns sistemas de arquivos, filtros e minifiltros da Microsoft para armazenar dados para um ponto de nova análise. Cada ponto de nova análise contém uma estrutura REPARSE_GUID_DATA_BUFFER.

Os pontos de nova análise da Microsoft podem usar a estrutura REPARSE_DATA_BUFFER em vez da estrutura REPARSE_GUID_DATA_BUFFER. No entanto, pontos de nova análise de terceiros são necessários para usar a estrutura REPARSE_GUID_DATA_BUFFER.

As marcas de ponto de nova análise são atribuídas a terceiros pela Microsoft. Você pode solicitar mais de um ponto de nova análise para uso com um sistema de arquivos, um driver de filtro do sistema de arquivos ou um driver de minifiltro.

GuiDs de ponto de nova análise não são atribuídos pela Microsoft. No entanto, você deve escolher um GUID para usar com a marca de ponto de nova análise atribuída e sempre deve usar esse GUID com a marca. Para gerar um GUID, você pode usar GUIDGen (Guidgen.exe), uma ferramenta incluída no SDK do Microsoft Windows.

Minifilters podem definir ou excluir um ponto de nova análise chamando FltTagFile ou FltUntagFile. Os minifiltros podem recuperar um ponto de nova análise usando o código de controle FSCTL_GET_REPARSE_POINT . Esse código pode ser enviado para o sistema de arquivos chamando FltFsControlFile.

Os sistemas de arquivos e os drivers de filtro podem recuperar, definir ou excluir um ponto de nova análise usando os códigos de controle FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINT e FSCTL_DELETE_REPARSE_POINT . Esses códigos podem ser enviados para o sistema de arquivos chamando ZwFsControlFile.

Para obter mais informações sobre pontos de nova análise e marcas de ponto de nova análise, consulte a documentação do SDK do Windows.