NETWORK_OPEN_ECP_CONTEXT struttura (ntifs.h)

Articolo
02/29/2024

La struttura NETWORK_OPEN_ECP_CONTEXT viene usata per interpretare i contesti del parametro di creazione aggiuntivi di rete (ECP) 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;

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-create) e per l'applicazione al file dopo l'apertura (post-create).

DUMMYSTRUCTNAME.in

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

DUMMYSTRUCTNAME.in.Location

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

DUMMYSTRUCTNAME.in.Integrity

Valore NETWORK_OPEN_INTEGRITY_QUALIFIER tipizzato 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 reindirizzamento SMB che la richiesta aperta in ingresso non deve essere piggyback e compressa in un handle aperto esistente nello stesso file.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Causa la disabilitabilità del reindirizzamento SMB2+ su questo handle aperto. Per altre informazioni sull'apertura di un file per un'operazione durevole, vedere Richieste applicazione Creazione di un file aperto per un'operazione durevole.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Indica al reindirizzamento 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 l'uso interno e non deve essere usato dalle applicazioni. Questo flag impone al reindirizzamento di usare I/O sincroni anche se l'handle è stato aperto per i/O asincroni.

DUMMYSTRUCTNAME.out

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

DUMMYSTRUCTNAME.out.Location

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

DUMMYSTRUCTNAME.out.Integrity

Valore NETWORK_OPEN_INTEGRITY_QUALIFIER tipizzato 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 reindirizzamento SMB che la richiesta aperta in ingresso non deve essere piggyback e compressa in un handle aperto esistente nello stesso file.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Causa la disabilitabilità del reindirizzamento SMB2+ su questo handle aperto. Per altre informazioni sull'apertura di un file per un'operazione durevole, vedere Richieste applicazione Creazione di un file aperto per un'operazione durevole.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Riservato per l'uso interno e non deve essere usato dalle applicazioni. Questo flag impone al reindirizzamento di usare I/O sincroni anche se l'handle è stato aperto per i/O asincroni.

Commenti

Per informazioni su come usare gli ECP per associare informazioni aggiuntive a un file quando viene creato il file, vedere Uso di parametri di creazione aggiuntivi con un'operazione di IRP_MJ_CREATE.

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 ha riconosciuto la struttura del contesto NETWORK_OPEN_ECP_CONTEXT , il chiamante deve chiamare il chiamante FltIsEcpAcknowledged o FsRtlIsEcpAcknowledged sulla routine ECP dopo il completamento 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, i membri DUMMYSTRUCTNAME.in.Flags e DUMMYSTRUCTNAME.out.Flags sono supportati solo a partire da Windows 7.