CREATEFILE2_EXTENDED_PARAMETERS struttura (fileapi.h)

Contiene parametri estesi facoltativi per CreateFile2.

Sintassi

typedef struct _CREATEFILE2_EXTENDED_PARAMETERS {
  DWORD                 dwSize;
  DWORD                 dwFileAttributes;
  DWORD                 dwFileFlags;
  DWORD                 dwSecurityQosFlags;
  LPSECURITY_ATTRIBUTES lpSecurityAttributes;
  HANDLE                hTemplateFile;
} CREATEFILE2_EXTENDED_PARAMETERS, *PCREATEFILE2_EXTENDED_PARAMETERS, *LPCREATEFILE2_EXTENDED_PARAMETERS;

Members

dwSize

Contiene le dimensioni di questa struttura, sizeof(CREATEFILE2_EXTENDED_PARAMETERS).

dwFileAttributes

Gli attributi e i flag del file o del dispositivo FILE_ATTRIBUTE_NORMAL il valore predefinito più comune per i file.

Questo parametro può includere qualsiasi combinazione degli attributi di file disponibili (FILE_ATTRIBUTE_*). Tutti gli altri attributi di file sostituiscono FILE_ATTRIBUTE_NORMAL.

Alcuni degli attributi e dei flag di file seguenti possono essere applicati solo ai file e non necessariamente a tutti gli altri tipi di dispositivi che CreateFile2 possono aprire. Per altre informazioni, vedere la sezione Osservazioni della pagina di CreateFile2 riferimento e creazione e apertura di file.

Per un accesso più avanzato agli attributi di file, vedere SetFileAttributes. Per un elenco completo di tutti gli attributi di file con i relativi valori e descrizioni, vedere Costanti attributo file.

dwFileFlags

Questo parametro può contenere combinazioni di flag (FILE_FLAG_*) per il controllo del comportamento del file o della memorizzazione nella cache dei dispositivi, delle modalità di accesso e di altri flag a scopo speciale.

dwSecurityQosFlags

Il parametro dwSecurityQosFlags specifica le informazioni SQOS. Per altre informazioni, vedere Livelli di rappresentazione.

lpSecurityAttributes

Puntatore a una struttura SECURITY_ATTRIBUTES che contiene due membri dati separati ma correlati: un descrittore di sicurezza facoltativo e un valore booleano che determina se l'handle restituito può essere ereditato dai processi figlio.

Questo parametro può essere NULL.

Se questo parametro è NULL, l'handle restituito da CreateFile2 non può essere ereditato da eventuali processi figlio che l'applicazione può creare e il file o il dispositivo associato all'handle restituito ottiene un descrittore di sicurezza predefinito.

Il membro lpSecurityDescriptor della struttura specifica un SECURITY_DESCRIPTOR per un file o un dispositivo. Se questo membro è NULL, al file o al dispositivo associato all'handle restituito viene assegnato un descrittore di sicurezza predefinito.

CreateFile2 ignora il membro lpSecurityDescriptor quando si apre un file o un dispositivo esistente, ma continua a usare il membro bInheritHandle .

Il membro bInheritHandle della struttura specifica se l'handle restituito può essere ereditato.

Per altre informazioni, vedere la sezione Osservazioni dell'argomento CreateFile2 .

hTemplateFile

Handle valido per un file modello con il diritto di accesso GENERIC_READ . Il file modello fornisce attributi di file e attributi estesi per il file in fase di creazione.

Questo parametro può essere NULL.

Quando si apre un file esistente, CreateFile2 ignora questo parametro.

Quando si apre un nuovo file crittografato, il file eredita l'elenco di controllo di accesso discrezionale dalla directory padre. Per altre informazioni, vedere Crittografia file.

Commenti

Per compilare un'applicazione che usa la struttura CREATEFILE2_EXTENDED_PARAMETERS , definire la macro _WIN32_WINNT come 0x0602 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Comportamento di memorizzazione nella cache

Diversi valori possibili per il membro dwFileFlags vengono usati per controllare o influire sulla modalità di memorizzazione dei dati associati all'handle dal sistema. ovvero:

• FILE_FLAG_NO_BUFFERING
• FILE_FLAG_RANDOM_ACCESS
• FILE_FLAG_SEQUENTIAL_SCAN
• FILE_FLAG_WRITE_THROUGH
• FILE_ATTRIBUTE_TEMPORARY

Se nessuno di questi flag viene specificato, il sistema usa uno schema di memorizzazione nella cache per utilizzo generico predefinito. In caso contrario, la memorizzazione nella cache del sistema si comporta come specificato per ogni flag.

Alcuni di questi flag non devono essere combinati. Ad esempio, la combinazione di FILE_FLAG_RANDOM_ACCESS con FILE_FLAG_SEQUENTIAL_SCAN è auto-sconfitta.

La specifica del flag FILE_FLAG_SEQUENTIAL_SCAN può migliorare le prestazioni per le applicazioni che leggono file di grandi dimensioni usando l'accesso sequenziale. I miglioramenti delle prestazioni possono essere ancora più evidenti per le applicazioni che leggono file di grandi dimensioni principalmente in sequenza, ma occasionalmente saltano avanti su intervalli ridotti di byte. Se un'applicazione sposta il puntatore di file per l'accesso casuale, è probabile che non si verifichino prestazioni ottimali di memorizzazione nella cache. Tuttavia, l'operazione corretta è comunque garantita.

I flag FILE_FLAG_WRITE_THROUGH e FILE_FLAG_NO_BUFFERING sono indipendenti e possono essere combinati.

Se FILE_FLAG_WRITE_THROUGH viene usato ma non viene specificato FILE_FLAG_NO_BUFFERING, in modo che la memorizzazione nella cache del sistema sia effettiva, i dati vengono scritti nella cache di sistema ma vengono scaricati su disco senza ritardo.

Se FILE_FLAG_WRITE_THROUGH e FILE_FLAG_NO_BUFFERING sono entrambi specificati, in modo che la memorizzazione nella cache del sistema non sia effettiva, i dati vengono immediatamente scaricati su disco senza passare dalla cache del sistema Windows. Il sistema operativo richiede anche un write-through della cache hardware locale del disco rigido per supporti persistenti.

L'uso appropriato del flag di FILE_FLAG_NO_BUFFERING richiede considerazioni speciali sull'applicazione. Per altre informazioni, vedere Buffering file.

Una richiesta di scrittura tramite FILE_FLAG_WRITE_THROUGH causa anche lo scaricamento di eventuali modifiche ai metadati, ad esempio un aggiornamento del timestamp o un'operazione di ridenominazione, che comporta l'elaborazione della richiesta. Per questo motivo, il flag di FILE_FLAG_WRITE_THROUGH viene spesso usato con il flag FILE_FLAG_NO_BUFFERING come sostituzione per chiamare la funzione FlushFileBuffers dopo ogni scrittura, che può causare penali per le prestazioni non necessarie. L'uso di questi flag consente di evitare tali sanzioni. Per informazioni generali sulla memorizzazione nella cache dei file e dei metadati, vedere Memorizzazione nella cache dei file.

Quando FILE_FLAG_NO_BUFFERING viene combinato con FILE_FLAG_OVERLAPPED, i flag offrono prestazioni asincrone massime, perché l'I/O non si basa sulle operazioni sincrone della gestione memoria. Tuttavia, alcune operazioni di I/O richiedono più tempo, perché i dati non vengono mantenuti nella cache. Inoltre, i metadati dei file possono comunque essere memorizzati nella cache, ad esempio durante la creazione di un file vuoto. Per assicurarsi che i metadati vengano scaricati su disco, usare la funzione FlushFileBuffers .

Se è disponibile una memoria di cache sufficiente, l'attributo FILE_ATTRIBUTE_TEMPORARY causa l'eliminazione di un file system temporaneo dopo la chiusura di un handle. In tal caso, il sistema può evitare completamente di scrivere i dati. Anche se non controlla direttamente la memorizzazione nella cache dei dati nello stesso modo dei flag menzionati in precedenza, l'attributo FILE_ATTRIBUTE_TEMPORARY indica al sistema di conservare il più possibile nella cache di sistema senza scrivere e pertanto può essere di preoccupazione per determinate applicazioni.

Handle di I/O sincroni e sincroni

CreateFile2 fornisce la creazione di un handle di file o dispositivo sincrono o asincrono. Un handle sincrono si comporta in modo che le chiamate di funzione di I/O usando tale handle vengano bloccate fino al completamento, mentre un handle di file asincrono consente al sistema di restituire immediatamente dalle chiamate di funzione I/O, indipendentemente dal completamento dell'operazione di I/O o. Come indicato in precedenza, questo comportamento sincrono o asincrono viene determinato specificando FILE_FLAG_OVERLAPPED all'interno del membro dwFileFlags della struttura CREATEFILE2_EXTENDED_PARAMETERS passata nel parametro pCreateExParams . Esistono diverse complessità e potenziali insodenze durante l'uso di I/O asincrone; per altre informazioni, vedere I/O sincrona e asincrona.

Requisiti

Vedi anche

CreateFile2

Strutture di gestione file