REPARSE_GUID_DATA_BUFFER 구조체(ntifs.h)

아티클
02/29/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

재분석 지점의 소유자를 고유하게 식별하는 재분석 지점 태그입니다. (다음 설명 섹션 을 참조하세요.)

ReparseDataLength

DataBuffer 멤버의 재분석 데이터의 크기(바이트)입니다.

Reserved

예약되어 있으므로 사용하지 마세요.

ReparseGuid

재분석 지점의 소유자를 고유하게 식별하는 GUID입니다. (다음 설명 섹션 을 참조하세요.)

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

재분석 지점에 대한 사용자 정의 데이터입니다. 이 데이터의 형식은 재분석 지점의 소유자가 정의합니다.

설명

REPARSE_GUID_DATA_BUFFER 구조는 모든 타사 파일 시스템, 필터 및 미니필터뿐만 아니라 일부 Microsoft 파일 시스템, 필터 및 미니 필터에서 재분석 지점에 대한 데이터를 저장하는 데 사용됩니다. 각 재분석 지점에는 하나의 REPARSE_GUID_DATA_BUFFER 구조가 포함됩니다.

Microsoft 재분석 지점은 REPARSE_GUID_DATA_BUFFER 구조 대신 REPARSE_DATA_BUFFER 구조를 사용할 수 있습니다. 그러나 REPARSE_GUID_DATA_BUFFER 구조를 사용하려면 타사 재분석 지점이 필요합니다.

재분석 지점 태그는 Microsoft에서 제3자에게 할당합니다. 파일 시스템, 파일 시스템 필터 드라이버 또는 미니필터 드라이버와 함께 사용할 재분석 지점을 둘 이상 요청할 수 있습니다.

재분석 지점 GUID는 Microsoft에서 할당하지 않습니다. 그러나 할당된 재분석 지점 태그와 함께 사용할 GUID를 하나 선택해야 하며 항상 태그와 함께 이 GUID를 사용해야 합니다. GUID를 생성하려면 Microsoft Windows SDK 포함된 도구인 GUIDGen(Guidgen.exe)을 사용할 수 있습니다.

미니 필터는 FltTagFile 또는 FltUntagFile을 호출하여 재분석 지점을 설정하거나 삭제할 수 있습니다. 미니필터는 FSCTL_GET_REPARSE_POINT 제어 코드를 사용하여 재분석 지점을 검색할 수 있습니다. 이 코드는 FltFsControlFile을 호출하여 파일 시스템으로 보낼 수 있습니다.

파일 시스템 및 필터 드라이버는 FSCTL_GET_REPARSE_POINT, FSCTL_SET_REPARSE_POINT 및 FSCTL_DELETE_REPARSE_POINT 제어 코드를 사용하여 재분석 지점을 검색, 설정 또는 삭제할 수 있습니다. 이러한 코드는 ZwFsControlFile을 호출하여 파일 시스템으로 보낼 수 있습니다.

지점 재분석 및 지점 태그 재분석에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.