struttura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

La struttura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contiene il contesto di creazione aggiuntivo (ECP) che può essere inviato al file system volumi condivisi cluster (CSV) per impostare le proprietà per la modalità di gestione delle operazioni di I/O in arrivo in questa apertura.

Sintassi

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Members

Size

Dimensioni di questa struttura, in byte.

PauseTimeoutInSeconds

Numero di secondi per cui CSVFS può contenere operazioni di I/O rilasciate su questo oggetto file in uno stato in sospeso in caso di sospensione del volume CSV. Una volta scaduto, csv completerà tutte le operazioni di I/O rilasciate in questo oggetto file con stato STATUS_CSV_IO_PAUSE_TIMEOUT. Questo membro può essere uno dei valori seguenti.

Valore Significato
0xffffffff Indica che non è presente alcun timeout e viene richiesto il comportamento predefinito.
0 CSV non sospende I/O e completerà immediatamente I/O.
Qualsiasi altro valore CSV arrotonda tutti gli altri valori a un multiplo di 10 secondi e usa questo valore come timeout. Il valore massimo di timeout supportato è 30 minuti. Se il valore specificato è maggiore di 30 minuti, CSV imposterà automaticamente il valore sul valore massimo.

Flags

Flag di proprietà set. Questo membro può essere un OR bit per bit dei flag seguenti.

Contrassegno Significato
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR Indica a CSVFS che questo file aperto deve essere valido solo nel nodo di coordinamento. Se l'apertura arriva a CSVFS e il nodo non è un nodo di coordinamento, l'apertura avrà esito negativo. Se il file viene aperto e il nodo di coordinamento viene spostato, l'apertura del file verrà invalidata. Questo flag viene usato solo quando il file viene aperto direttamente in CSVFS e viene ignorato quando il file viene aperto su SMB.

I 16 bit inferiori di Flag sono per i flag che causano l'esito negativo della creazione con STATUS_INVALID_PARAMETER se CSV non li riconosce. I 16 bit superiori sono per i flag che verrebbero ignorati automaticamente se CSVFS non sa come gestirli.

Commenti

Il valore di GUID_ECP_CSV_SET_HANDLE_PROPERTIES 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 8
Intestazione ntifs.h