struttura NETWORK_OPEN_ECP_CONTEXT (ntifs.h)

Articolo
12/21/2024

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

Sintassi

typedef struct _NETWORK_OPEN_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_IN_FLAGS            Flags;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_OUT_FLAGS           Flags;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT, *PNETWORK_OPEN_ECP_CONTEXT;

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.in.Flags

Supportato a partire da Windows 7. Valore che specifica gli attributi per il file. Questo membro è un OR bit per bit di uno dei flag seguenti.

Valore	Significato
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica al redirector SMB che la richiesta aperta in ingresso non deve essere inserita nel piggyback e compressa in un handle aperto esistente nello stesso file.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Fa sì che il redirector SMB2+ disabiliti la durabilità in questo handle aperto. Per altre informazioni sull'apertura di un file per un'operazione durevole, vedere Richieste dell'applicazione Creazione di un file aperto per durable operation.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Indica al redirector SMB di non concedere oplock per la richiesta aperta in ingresso. Questo flag è disponibile a partire da Windows 8.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Riservato per uso interno e non deve essere usato dalle applicazioni. Questo flag impone al redirector di usare operazioni di I/O sincrone anche se l'handle è stato aperto per l'I/O asincrona.

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

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

DUMMYSTRUCTNAME.out.Flags

Supportato a partire da Windows 7. Valore che specifica gli attributi per il file. Questo membro è un OR bit per bit di uno dei flag seguenti.

Valore	Significato
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica al redirector SMB che la richiesta aperta in ingresso non deve essere inserita nel piggyback e compressa in un handle aperto esistente nello stesso file.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Fa sì che il redirector SMB2+ disabiliti la durabilità in questo handle aperto. Per altre informazioni sull'apertura di un file per un'operazione durevole, vedere Richieste dell'applicazione Creazione di un file aperto per durable operation.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Riservato per uso interno e non deve essere usato dalle applicazioni. Questo flag impone al redirector di usare operazioni di I/O sincrone anche se l'handle è stato aperto per l'I/O asincrona.

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, il chiamante deve chiamare il FltIsEcpAcknowledged o FsRtlIsEcpAcknowledged routine su ECP al termine dell'operazione.

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.

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, il DUMMYSTRUCTNAME.in.Flags e DUMMYSTRUCTNAME.out.Flags membri sono supportati solo a partire da Windows 7.