通过

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT结构 （ntifs.h）

  • 项目

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 结构包含可以发送到群集共享卷（CSV）文件系统的额外创建参数（ECP）上下文，以设置如何处理到达此打开的 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

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

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

Flags

set 属性标志。 此成员可以是以下标志的按位 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