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 相关的支持例程(如 FltAllocateExtraCreateParameterFsRtlRemoveExtraCreateParameter)时,系统定义的GUID_ECP_OPEN_PARAMETERS值用于此 ECP 上下文结构。

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

要求

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

另请参阅

FltAllocateExtraCreateParameterList

FltCreateFileEx2