ntifs.h) (NETWORK_OPEN_ECP_CONTEXT_V0 结构
NETWORK_OPEN_ECP_CONTEXT_V0 结构用于解释文件上的 ECP) 上下文 (网络额外创建参数。
语法
typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
USHORT Size;
USHORT Reserved;
struct {
struct {
NETWORK_OPEN_LOCATION_QUALIFIER Location;
NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
} in;
struct {
NETWORK_OPEN_LOCATION_QUALIFIER Location;
NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
} out;
} DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;
成员
Size
此结构的大小(以字节为单位)。
Reserved
保留。 必须设置为零。
DUMMYSTRUCTNAME
一个 结构,其中包含用于打开文件 (预创建) 的限制,以及 (创建后) 打开文件后应用于该文件的限制。
DUMMYSTRUCTNAME.in
包含用于打开文件的预创建限制的结构。
DUMMYSTRUCTNAME.in.Location
一个NETWORK_OPEN_LOCATION_QUALIFIER类型的值,该值指定要附加到文件的位置限制。
DUMMYSTRUCTNAME.in.Integrity
一个NETWORK_OPEN_INTEGRITY_QUALIFIER类型的值,该值指定要附加到文件的完整性限制。
DUMMYSTRUCTNAME.out
包含创建后的限制的结构,这些限制将在文件打开后应用于该文件。
DUMMYSTRUCTNAME.out.Location
一个NETWORK_OPEN_LOCATION_QUALIFIER类型的值,该值指定要附加到文件的位置限制。
DUMMYSTRUCTNAME.out.Integrity
此成员当前未实现,应忽略。
一个NETWORK_OPEN_INTEGRITY_QUALIFIER类型的值,该值指定要附加到文件的完整性限制。
注解
有关如何在创建文件时使用 ECP 将额外信息与文件关联的信息,请参阅 将额外创建参数与IRP_MJ_CREATE操作配合使用。
筛选器驱动程序应将 NETWORK_OPEN_ECP_CONTEXT 结构视为只读结构,仅使用它来检索有关文件上的网络 ECP 上下文的信息。 有关详细信息,请参阅 系统定义的 ECP。
如果调用方必须验证文件系统是否确认 NETWORK_OPEN_ECP_CONTEXT_V0 上下文结构,则调用方应在操作完成后对 ECP 调用 FltIsEcpAcknowledgeded 或 FsRtlIsEcpAcknowledged 例程。
在大多数情况下,在 Windows Vista 和更高版本的 Windows 上运行的驱动程序使用 NETWORK_OPEN_ECP_CONTEXT 结构来解释文件上的网络 ECP 上下文。 但是,在 Windows 7 及更高版本的 Windows 上运行且必须解释驻留在 Windows Vista 上的文件上的网络 ECP 上下文的驱动程序必须改用 NETWORK_OPEN_ECP_CONTEXT_V0 结构。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 此结构从 Windows 7 开始可用。 |
标头 | ntifs.h (包括 Ntifs.h) |