NETWORK_OPEN_ECP_CONTEXT_V0 structure

The NETWORK_OPEN_ECP_CONTEXT_V0 structure is used to interpret network ECP contexts on files.

Syntax

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;

Members

• Size
  The size, in bytes, of this structure.

• Reserved
  Reserved. Must be set to zero.

• DUMMYSTRUCTNAME
  A structure that contains restrictions to apply for opening the file and to apply to the file after it is opened.

  • in
    A structure in the DUMMYSTRUCTNAME structure that contains restrictions for opening a file.

    • Location
      A NETWORK_OPEN_LOCATION_QUALIFIER-typed value that specifies the location restriction to attach to the file.

    • Integrity
      This member is currently not implemented and should be ignored.

      A NETWORK_OPEN_INTEGRITY_QUALIFIER-typed value that specifies the integrity restriction to attach to the file.

  • out
    A structure in the DUMMYSTRUCTNAME structure that contains information that a file provides after it is opened.

    • Location
      A NETWORK_OPEN_LOCATION_QUALIFIER-typed value that specifies the location restriction to attach to the file.

    • Integrity
      This member is currently not implemented and should be ignored.

      A NETWORK_OPEN_INTEGRITY_QUALIFIER-typed value that specifies the integrity restriction to attach to the file.

Remarks

For information about how to use ECPs to associate extra information with a file when the file is created, see Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

The NETWORK_OPEN_ECP_CONTEXT_V0 structure is read-only. You should use it to retrieve information about the network ECP context on a file only. For more information about this issue, see System-Defined ECPs.

If a caller must verify that the file system acknowledged the NETWORK_OPEN_ECP_CONTEXT_V0 context structure, the caller should call the FltIsEcpAcknowledged or FsRtlIsEcpAcknowledged routine on the ECP after the operation is complete.

In most cases, drivers that run on Windows Vista and later versions of Windows use the NETWORK_OPEN_ECP_CONTEXT structure to interpret network ECP contexts on files. However, drivers that run on Windows 7 and later versions of Windows and that must interpret network ECP contexts on files that reside on Windows Vista must use the NETWORK_OPEN_ECP_CONTEXT_V0 structure instead.

Requirements

See also

NETWORK_OPEN_ECP_CONTEXT

NETWORK_OPEN_INTEGRITY_QUALIFIER

NETWORK_OPEN_LOCATION_QUALIFIER

Send comments about this topic to Microsoft