struttura NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Articolo
02/26/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;

Members

Size

Dimensione, in byte, della 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 tipizzato NETWORK_OPEN_LOCATION_QUALIFIER che specifica la restrizione del percorso da allegare al file.

DUMMYSTRUCTNAME.in.Integrity

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

DUMMYSTRUCTNAME.out

Struttura che contiene restrizioni successive alla creazione da applicare a un file dopo l'apertura.

DUMMYSTRUCTNAME.out.Location

Valore tipizzato NETWORK_OPEN_LOCATION_QUALIFIER che specifica la restrizione del percorso da allegare al file.

DUMMYSTRUCTNAME.out.Integrity

Questo membro non è attualmente implementato e deve essere ignorato.

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

Commenti

Per informazioni su come usare gli ecp per associare informazioni aggiuntive a un file al momento della creazione del file, vedere Using Extra Create Parameters with an IRP_MJ_CREATE Operation .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.

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

Se un chiamante deve verificare che il file system riconobbe la struttura del contesto NETWORK_OPEN_ECP_CONTEXT_V0 , il chiamante deve chiamare la routine FltIsEcpAcknowledged o FsRtlIsEcpAcknowledged nell'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 .