NETWORK_OPEN_ECP_CONTEXT struttura (ntifs.h)
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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Questa struttura è disponibile a partire da Windows Vista. |
Intestazione | ntifs.h (include Ntifs.h) |