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_DATA_BUFFER 結構，而不是REPARSE_GUID_DATA_BUFFER結構。不過，必須使用第三方重新分析點，才能使用REPARSE_GUID_DATA_BUFFER結構。

Microsoft 會將重新分析點標記指派給第三方。您可以要求多個重新分析點，以便與文件系統、文件系統篩選驅動程式或迷你篩選驅動程式搭配使用。

Microsoft 不會指派重新分析點 GUID。不過，您必須選擇一個 GUID 來搭配指派的重新分析點標籤使用，而且您必須一律將此 GUID 與標記搭配使用。若要產生 GUID，您可以使用 GUIDGen (Guidgen.exe) ，這是包含在 Microsoft Windows SDK 中的工具。

迷你篩選可以藉由呼叫 FltTagFile 或 FltUntagFile 來設定或刪除重新分析點。迷你篩選可以使用 FSCTL_GET_REPARSE_POINT 控件程式代碼來擷取重新分析點。此程式代碼可以藉由呼叫 FltFsControlFile 傳送至文件系統。

檔系統和篩選驅動程式可以使用 FSCTL_GET_REPARSE_POINT、 FSCTL_SET_REPARSE_POINT和 FSCTL_DELETE_REPARSE_POINT 控制程式代碼來擷取、設定或刪除重新分析點。這些程式代碼可以藉由呼叫 ZwFsControlFile 傳送至文件系統。

如需重新分析點和重新分析點標記的詳細資訊，請參閱 Windows SDK 檔。