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) |