REPARSE_DATA_BUFFER_EX結構 (ntifs.h)

  • 發行項

REPARSE_DATA_BUFFER_EX結構包含重新分析點的數據。

語法

typedef struct _REPARSE_DATA_BUFFER_EX {
  ULONG     Flags;
  ULONG     ExistingReparseTag;
  GUID      ExistingReparseGuid;
  ULONGLONG Reserved;
  union {
    REPARSE_DATA_BUFFER      ReparseDataBuffer;
    REPARSE_GUID_DATA_BUFFER ReparseGuidDataBuffer;
  } DUMMYUNIONNAME;
} REPARSE_DATA_BUFFER_EX, *PREPARSE_DATA_BUFFER_EX;

成員

Flags

可以是下列值：

旗標值 意義
REPARSE_DATA_EX_FLAG_GIVEN_TAG_OR_NONE 如果檔案沒有標記，或檔案上的標記與 ExistingReparseTag 中的標籤相同，則強制FSCTL_SET_REPARSE_POINT_EX設定重新分析標籤。 注意：如果 ExistingReparseTag 不是 Microsoft 標籤，則如果檔案已經有 ExistingReparseTag，則 ExistingReparseGuid 應該相符 。

ExistingReparseTag

如果呼叫端想要同時取代重新分析標籤，請重新分析檔案上的點標記。

  • 若要設定重新分析數據以及可能不同的重新分析標籤， ExistingReparseTag 應該是檔案目前的重新分析標籤。
  • 若要更新重新分析數據，同時維護相同的重新分析標籤， ExistingReparseTag 應該是現有的重新分析標籤。
  • 若要在還沒有重新分析卷標的檔案上設定重新分析標籤以及重新分析數據， ExistingReparseTag 應設定為零。

ExistingReparseGuid

如果是非 Microsoft 重新分析標籤，當呼叫端想要取代重新分析標籤和/或 GUID 以及數據時，這是檔案上現有的重新分析 GUID。 如果 ExistingReparseTag 為零，則檔案不預期會有任何重新剖析卷標，因此會忽略 ExistingReparseGuid 。 如果是非 Microsoft 標籤，如果 ExistingReparseTag 不是零，則 ExistingReparseGuid 應該符合檔案中的 GUID。

Reserved

保留的。 請勿使用。

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparseDataBuffer

包含 Microsoft 定義重新分析點數據的 REPARSE_DATA_BUFFER 結構。

DUMMYUNIONNAME.ReparseGuidDataBuffer

包含重新分析點數據的 REPARSE_GUID_DATA_BUFFER 結構。 第三方重新分析點必須使用這個結構。

備註

REPARSE_DATA_BUFFER_EX結構可用來儲存重新分析點的數據。 透過 FSCTL_SET_REPARSE_POINT_EX IOCTL 在檔案或目錄上設定重新分析點時，請使用 REPARSE_DATA_BUFFER_EX 。

規格需求

需求 值
標頭 ntifs.h

另請參閱

FSCTL_SET_REPARSE_POINT_EX

REPARSE_DATA_BUFFER

REPARSE_GUID_DATA_BUFFER