NETWORK_OPEN_ECP_CONTEXT_V0结构（ntifs.h）

项目
12/21/2024

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 上下文的信息。有关详细信息，请参阅 System-Defined ECP。

如果调用方必须验证文件系统是否确认 NETWORK_OPEN_ECP_CONTEXT_V0 上下文结构，调用方应在操作完成后调用 ECP 上的 FltIsEcpAcknowledged 或 FsRtlIsEcpAcknowledged 例程。

在大多数情况下，在 Windows Vista 和更高版本的 Windows 上运行的驱动程序使用 NETWORK_OPEN_ECP_CONTEXT 结构来解释文件上的网络 ECP 上下文。但是，在 Windows 7 及更高版本的 Windows 上运行且必须解释驻留在 Windows Vista 上的文件的网络 ECP 上下文的驱动程序必须改用 NETWORK_OPEN_ECP_CONTEXT_V0 结构。