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 (0x0001) | ファイルを開いて読み取ります。 |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) | ファイルを開いて書き込みます。 |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) | ファイルを開いて削除します。 |
| ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) | 大文字と小文字を区別するディレクトリの下でも、このファイルの大文字と小文字を区別しない検索を強制的に開きます。 Windows 10 バージョン 2004 以降で使用できます。 |
| ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) | パスに大文字と小文字が区別されるディレクトリがある場合、ファイルを開いたり、要求を作成したりできません。 Windows 10 バージョン 2004 以降で使用できます。 |
注釈
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READフラグとECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE フラグを使用すると、暗号化されたファイルに対する読み取り/書き込みアクセスが許可され、読み取り/書き込みアクセスのためにそのようなファイルを実際に開く必要はありません。 これらの ECP フラグを使用すると、カーネル モード コンポーネントをメタデータのみのアクセス用に開くことができるようになります。そのため、読み取り/書き込みを行うために暗号化コンテキストの設定を取得しながら、他のアクセスに干渉することはありません。 フィルターは、ロックとの競合を回避するために、これらのフラグを設定できます。 読み取り/書き込み操作の暗号化状態の設定はコストがかかり、通常、ファイルが読み取り/書き込みアクセス用に開かれていない場合は実行されません。
システム定義のGUID_ECP_OPEN_PARAMETERS値は、 FltAllocateExtraCreateParameter や FsRtlRemoveExtraCreateParameter などの ECP 関連のサポート ルーチンを呼び出すときに、この ECP コンテキスト構造で使用されます。
詳細については、「 追加の作成パラメーターの概要 」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10バージョン 1709。 |
| Header | ntifs.h (Ntifs.h を含む) |