ntifs.h) (NETWORK_OPEN_ECP_CONTEXT_V0 结构

项目
08/07/2023

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 结构。