Condividi tramite

struttura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

  • Articolo

La struttura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contiene il contesto del parametro di creazione aggiuntivo (ECP) che può essere inviato al file system dei volumi condivisi cluster (CSV) per impostare le proprietà per la modalità di arrivo dell'I/O all'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;

Membri

Size

Dimensioni di questa struttura, in byte.

PauseTimeoutInSeconds

Numero di secondi per cui CSVFS può contenere I/O emessi su questo oggetto file in uno stato in sospeso in caso di sospensione del volume CSV. Una volta scaduto il file CSV, 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 l'I/O e completerà immediatamente I/O.
Qualsiasi altro valore CSV arrotonderà tutti gli altri valori a un multiplo di 10 secondi e userà questo valore come timeout. Il valore di timeout massimo supportato è 30 minuti. Se il valore specificato è maggiore di 30 minuti, CSV imposta automaticamente il valore sul valore massimo.

Flags

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

Bandiera 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 causerebbero 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.

Osservazioni

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.

Fabbisogno

Requisito Valore
client minimo supportato Windows 8
intestazione ntifs.h