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 (include Ntifs.h) |