ATOMIC_CREATE_ECP_CONTEXT構造体 (ntifs.h)

ATOMIC_CREATE_ECP_CONTEXT 構造体には、追加の create パラメーター (ECP) コンテキストが含まれています。これにより、作成中に補足操作をファイルにアトミックに実行できます。

構文

typedef struct _ATOMIC_CREATE_ECP_CONTEXT {
  USHORT               Size;
  USHORT               InFlags;
  USHORT               OutFlags;
  USHORT               ReparseBufferLength;
  PREPARSE_DATA_BUFFER ReparseBuffer;
  LONGLONG             FileSize;
  LONGLONG             ValidDataLength;
  PFILE_TIMESTAMPS     FileTimestamps;
  ULONG                FileAttributes;
  ULONG                UsnSourceInfo;
  USN                  Usn;
  ULONG                SuppressFileAttributeInheritanceMask;
  ULONG                InOpFlags;
  ULONG                OutOpFlags;
  ULONG                InGenFlags;
  ULONG                OutGenFlags;
  ULONG                CaseSensitiveFlagsMask;
  ULONG                InCaseSensitiveFlags;
  ULONG                OutCaseSensitiveFlags;
} ATOMIC_CREATE_ECP_CONTEXT, *PATOMIC_CREATE_ECP_CONTEXT;

メンバーズ

Size

このコンテキスト構造のサイズ (バイト単位)。

InFlags

作成操作で実行する要求された補足操作を示すフラグ。

OutFlags

正常な作成操作で実行された実際の補足操作を示すフラグ。

ReparseBufferLength

ReparseBuffer メンバーの長さ。 この値は、MAXIMUM_REPARSE_DATA_BUFFER_SIZE (16K) を超えることはできません。

ReparseBuffer

作成操作で使用されるバッファーの種類を示す省略可能な値。 指定できる値は、REPARSE_DATA_BUFFER または REPARSE_GUID_DATA_BUFFERです。

FileSize

ファイルに設定する要求されたファイル サイズを示すために、ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED と共に使用される省略可能な値。

ValidDataLength

ファイルに設定する要求された有効なデータ長を示すために、ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED と共に使用される省略可能な値。

FileTimestamps

ファイル上の特定のアクションの最後に記録されたインスタンスを含む省略可能な FILE_TIMESTAMPS 構造体へのポインター。

FileAttributes

ファイルの属性を指定します。

UsnSourceInfo

オプションの更新シーケンス番号 (USN) ソース情報フラグを指定します。

Usn

更新シーケンス番号 (USN) を指定します。 この値は、GUID_ECP_ATOMIC_CREATE の末尾に入力されます。

SuppressFileAttributeInheritanceMask

通常の継承規則を抑制する必要があるファイル属性を示すマスク。

InOpFlags

ATOMIC_CREATE_ECP_IN_OP_FLAG_xxxフラグ。

OutOpFlags

ATOMIC_CREATE_ECP_OUT_OP_FLAG_xxxフラグ。

InGenFlags

フラグをATOMIC_CREATE_ECP_IN_GN_FLAG_xxxします。

OutGenFlags

ATOMIC_CREATE_ECP_OUT_GN_FLAG_xxxフラグ。

CaseSensitiveFlagsMask

指定するFILE_CS_FLAG_xxxフラグを示します。ファイル システムは、他のフラグの既定値を選択する必要があります。

InCaseSensitiveFlags

ファイルに大文字と小文字を区別するフラグを入力します。 BEST_EFFORTが指定されていない場合でも、ファイル システムは InCaseSensitiveFlags の一部を無視できます。 この動作は FileCaseSensitiveInformation に似ているので、呼び出し元は OutCaseSensitiveFlags 調べて、設定されているフラグを確認できます。 一部のファイルまたはディレクトリでフラグがサポートされていない場合は、BEST_EFFORTが有効になります。

OutCaseSensitiveFlags

このメンバーは、InCaseSensitiveFlags が指定されていない場合でも、ファイルで大文字と小文字を区別するフラグを返します。

備考

システム定義の GUID_ECP_ATOMIC_CREATE** 値は、FltAllocateExtraCreateParameter や fsRtlRemoveExtraCreateParameterなどの ECP 関連のサポート ルーチンを呼び出すときに、この ECP コンテキスト構造で使用されます。

詳細については、「追加の作成パラメーター の概要」を参照してください。

必要条件