ECP_OPEN_PARAMETERS 结构 (ntifs.h)

  • 项目

ECP_OPEN_PARAMETERS 结构包含 ECP) 上下文 (额外的创建参数，允许调用方指定打开文件的目的，而不会干扰现有句柄和/或机会锁 (oplocks) 文件。

语法

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 标志允许内核模式组件为仅元数据访问打开，因此不会干扰其他访问，同时仍获取加密上下文设置以执行读/写操作。 筛选器可以设置这些标志，以避免与锁定冲突。 为读取/写入操作设置加密状态的成本很高，并且通常不会在未打开文件进行读/写访问时完成。

调用与 ECP 相关的支持例程（例如 FltAllocateExtraCreateParameter 和 FsRtlRemoveExtraCreateParameter）时，系统定义的GUID_ECP_OPEN_PARAMETERS值与此 ECP 上下文结构一起使用。

有关详细信息 ，请参阅额外创建参数简介 。

要求

要求 值
最低受支持的客户端 Windows 10版本 1709。
标头 ntifs.h (包括 Ntifs.h)

另请参阅

FltAllocateExtraCreateParameterList

FltCreateFileEx2