struttura NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Articolo
12/21/2024

La struttura NETWORK_OPEN_ECP_CONTEXT_V0 viene usata per interpretare i contesti di creazione aggiuntivi di rete (ECP) nei file.

Sintassi

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;

Membri

Size

Dimensione, in byte, di questa struttura.

Reserved

Riservato. Deve essere impostato su zero.

DUMMYSTRUCTNAME

Struttura che contiene restrizioni da applicare per l'apertura del file (pre-creazione) e per l'applicazione al file dopo l'apertura (post-creazione).

DUMMYSTRUCTNAME.in

Struttura che contiene restrizioni di pre-creazione per l'apertura di un file.

DUMMYSTRUCTNAME.in.Location

Valore NETWORK_OPEN_LOCATION_QUALIFIER-typed che specifica la restrizione del percorso da collegare al file.

DUMMYSTRUCTNAME.in.Integrity

Valore NETWORK_OPEN_INTEGRITY_QUALIFIER-typed che specifica la restrizione di integrità da collegare al file.

DUMMYSTRUCTNAME.out

Struttura che contiene restrizioni di post-creazione da applicare a un file dopo l'apertura.

DUMMYSTRUCTNAME.out.Location

Valore NETWORK_OPEN_LOCATION_QUALIFIER-typed che specifica la restrizione del percorso da collegare al file.

DUMMYSTRUCTNAME.out.Integrity

Questo membro non è attualmente implementato e deve essere ignorato.

Valore NETWORK_OPEN_INTEGRITY_QUALIFIER-typed che specifica la restrizione di integrità da collegare al file.

Osservazioni

Per informazioni su come usare gli ECP per associare informazioni aggiuntive a un file quando viene creato il file, vedere Using Extra Create Parameters with an IRP_MJ_CREATE Operation.For information about how to use ECP to associate extra information with a file when the file is created, see Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

Un driver di filtro deve considerare la struttura di NETWORK_OPEN_ECP_CONTEXT di sola lettura, usandola solo per recuperare informazioni sul contesto ECP di rete in un file. Per altre informazioni, vedere System-Defined ECP.

Se un chiamante deve verificare che il file system abbia riconosciuto la struttura del contesto NETWORK_OPEN_ECP_CONTEXT_V0, il chiamante deve chiamare la routine FltIsEcpAcknowledged o FsRtlIsEcpAcknowledged su ECP al termine dell'operazione.

Nella maggior parte dei casi, i driver eseguiti in Windows Vista e versioni successive di Windows usano la struttura NETWORK_OPEN_ECP_CONTEXT per interpretare i contesti ECP di rete nei file. Tuttavia, i driver eseguiti in Windows 7 e versioni successive di Windows e che devono interpretare i contesti ECP di rete nei file che risiedono in Windows Vista devono usare invece la struttura NETWORK_OPEN_ECP_CONTEXT_V0.