ntifs.h) (CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 结构

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 结构包含额外的 create 参数 (ECP) 上下文，该参数可以发送到群集共享卷 (CSV) 文件系统，以设置属性，以便处理在此打开时到达的 IO。

语法

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

成员

Size

此结构的大小（以字节为单位）。

PauseTimeoutInSeconds

CSVFS 允许在 CSV 卷暂停时将此文件对象上发出的 IO 保持在挂起状态的秒数。 时间到期后，CSV 将完成此文件对象上发出的所有 IO，状态STATUS_CSV_IO_PAUSE_TIMEOUT。 此成员可以是以下值之一。

值	含义
0xFFFFFFFF	指示没有超时，并请求默认行为。
0	CSV 不会暂停 IO，并且会立即完成 IO。
任何其他值	CSV 会将所有其他值舍入为 10 秒的倍数，并使用此值作为超时值。 支持的最大超时值为 30 分钟。 如果提供的值大于 30 分钟，CSV 将以无提示方式将该值设置为最大值。

Flags

设置属性标志。 此成员可以是以下标志的按位 OR。

标志	含义
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR	告知 CSVFS 打开的此文件应仅在协调节点上有效。 如果打开到 CSVFS，并且该节点不是协调节点，则打开将失败。 如果打开文件并移动协调节点，则打开的文件将失效。 仅当直接在 CSVFS 上打开文件时，才使用此标志;通过 SMB 打开文件时，将忽略此标志。

标志 的下 16 位适用于在 CSV 无法识别时会导致创建失败并出现STATUS_INVALID_PARAMETER的标志。 如果 CSVFS 不知道如何处理标志，则高 16 位用于将忽略的标志。

注解

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

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

要求

要求	值
最低受支持的客户端	Windows 8
标头	ntifs.h