struttura ECP_OPEN_PARAMETERS (ntifs.h)

  • Articolo

La struttura ECP_OPEN_PARAMETERS contiene il contesto ECP (Create Parameters) aggiuntivo che consente a un chiamante di specificare lo scopo di apertura di un file senza interferire con handle e/o blocchi opportunistici esistenti (oplock) nel file.

Sintassi

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

Members

Size

Specifica le dimensioni di questa struttura di contesto, in byte.

Reserved

Riservato per utilizzi futuri. Deve essere inizializzato su 0.

Flags

Flag che specificano i parametri o lo scopo per l'apertura di un file. I flag possono essere qualsiasi combinazione dei valori seguenti:

Valore Descrizione
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) Apertura del file per leggerlo.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) Apertura del file in cui scrivere.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) Apertura del file per eliminarlo.
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) Forza una ricerca senza distinzione tra maiuscole e minuscole per questo file aperto, anche in una directory con distinzione tra maiuscole e minuscole. Disponibile a partire da Windows 10 versione 2004.
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) Non riesce l'apertura o la richiesta di creazione del file se nel percorso sono presenti directory con distinzione tra maiuscole e minuscole. Disponibile a partire da Windows 10 versione 2004.

Commenti

I flag ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ e ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE consentono l'accesso in lettura/scrittura ai file crittografati senza dover aprire effettivamente tali file per l'accesso in lettura/scrittura. Questi flag ECP consentono l'apertura di un componente in modalità kernel per l'accesso solo ai metadati, in modo da non interferire con altri accessi pur ottenendo la configurazione del contesto di crittografia per eseguire operazioni di lettura/scrittura. Un filtro può impostare questi flag per evitare conflitti con il blocco. La configurazione dello stato di crittografia per le operazioni di lettura/scrittura è costosa e in genere non viene eseguita quando i file non vengono aperti per l'accesso in lettura/scrittura.

Il valore di GUID_ECP_OPEN_PARAMETERS definito dal sistema viene usato con questa struttura di contesto ECP quando si chiamano routine di supporto correlate a ECP, ad esempio FltAllocateExtraCreateParameter e FsRtlRemoveExtraCreateParameter.

Per altre informazioni, vedere Introduzione ai parametri di creazione aggiuntivi .

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1709.
Intestazione ntifs.h (include Ntifs.h)

Vedi anche

FltAllocateExtraCreateParameterList

FltCreateFileEx2