ECP_OPEN_PARAMETERS構造体 (ntifs.h)

ECP_OPEN_PARAMETERS構造体には、呼び出し元がファイルの既存のハンドルや日和見ロック (oplocks) に干渉することなく、ファイルを開く目的を指定できる追加の create パラメーター (ECP) コンテキストが含まれています。

構文

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

メンバー

Size

このコンテキスト構造のサイズをバイト単位で指定します。

Reserved

将来利用するために予約されています。 これは 0 に初期化する必要があります。

Flags

ファイルを開くパラメーターまたは目的を指定するフラグ。 フラグ には、次の値の任意の組み合わせを指定できます。

注釈

ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READフラグとECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE フラグを使用すると、暗号化されたファイルに対する読み取り/書き込みアクセスが許可され、読み取り/書き込みアクセスのためにそのようなファイルを実際に開く必要はありません。 これらの ECP フラグを使用すると、カーネル モード コンポーネントをメタデータのみのアクセス用に開くことができるようになります。そのため、読み取り/書き込みを行うために暗号化コンテキストの設定を取得しながら、他のアクセスに干渉することはありません。 フィルターは、ロックとの競合を回避するために、これらのフラグを設定できます。 読み取り/書き込み操作の暗号化状態の設定はコストがかかり、通常、ファイルが読み取り/書き込みアクセス用に開かれていない場合は実行されません。

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

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

要件

こちらもご覧ください

FltAllocateExtraCreateParameterList

FltCreateFileEx2