次の方法で共有

ECP_OPEN_PARAMETERS構造体 (ntifs.h)

  • [アーティクル]

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

構文

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

メンバーズ

Size

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

Reserved

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

Flags

ファイルを開くパラメーターまたは目的を指定するフラグ。 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。
ヘッダー ntifs.h (Ntifs.h を含む)

関連項目

FltAllocateExtraCreateParameterList の

FltCreateFileEx2 の