CREATEFILE2_EXTENDED_PARAMETERS-Struktur (fileapi.h)

Enthält optionale erweiterte Parameter für CreateFile2.

Syntax

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;

Member

dwSize

Enthält die Größe dieser Struktur, sizeof(CREATEFILE2_EXTENDED_PARAMETERS).

dwFileAttributes

Die Datei- oder Geräteattribute und -flags FILE_ATTRIBUTE_NORMAL der gängigste Standardwert für Dateien.

Dieser Parameter kann eine beliebige Kombination der verfügbaren Dateiattribute (FILE_ATTRIBUTE_*) enthalten. Alle anderen Dateiattribute überschreiben FILE_ATTRIBUTE_NORMAL.

Einige der folgenden Dateiattribute und -flags gelten möglicherweise nur für Dateien und nicht unbedingt für alle anderen Gerätetypen, die createFile2 öffnen kann. Weitere Informationen finden Sie im Abschnitt "Hinweise" der CreateFile2 Referenzseite und unter Erstellen und Öffnen von Dateien.

Weitere Informationen zum erweiterten Zugriff auf Dateiattribute finden Sie unter SetFileAttributes. Eine vollständige Liste aller Dateiattribute mit ihren Werten und Beschreibungen finden Sie unter Dateiattributekonstanten.

dwFileFlags

Dieser Parameter kann Kombinationen von Flags (FILE_FLAG_*) zur Steuerung des Zwischenspeicherverhaltens von Dateien oder Geräten, Zugriffsmodi und anderen speziellen Flags enthalten.

dwSecurityQosFlags

Der dwSecurityQosFlags-Parameter gibt SQOS-Informationen an. Weitere Informationen finden Sie unter Identitätswechselebenen.

lpSecurityAttributes

Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die zwei separate, aber verwandte Datenmember enthält: einen optionalen Sicherheitsdeskriptor und einen booleschen Wert, der bestimmt, ob das zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann.

Dieser Parameter kann NULL sein.

Wenn dieser Parameter NULL ist, kann das von CreateFile2 zurückgegebene Handle nicht von untergeordneten Prozessen geerbt werden, die die Anwendung möglicherweise erstellt, und die Datei oder das Gerät, das dem zurückgegebenen Handle zugeordnet ist, erhält einen Standardsicherheitsdeskriptor.

Das lpSecurityDescriptor-Element der Struktur gibt einen SECURITY_DESCRIPTOR für eine Datei oder ein Gerät an. Wenn dieses Element NULL ist, wird der Datei oder dem gerät, das dem zurückgegebenen Handle zugeordnet ist, eine Standardsicherheitsbeschreibung zugewiesen.

CreateFile2 ignoriert den lpSecurityDescriptor-Member beim Öffnen einer vorhandenen Datei oder eines vorhandenen Geräts, verwendet aber weiterhin das bInheritHandle-Element .

Das bInheritHandle-Element der Struktur gibt an, ob das zurückgegebene Handle geerbt werden kann.

Weitere Informationen finden Sie im Abschnitt Hinweise des Themas CreateFile2 .

hTemplateFile

Ein gültiges Handle für eine Vorlagendatei mit dem GENERIC_READ Zugriffsrecht. Die Vorlagendatei stellt Dateiattribute und erweiterte Attribute für die zu erstellende Datei bereit.

Dieser Parameter kann NULL sein.

Beim Öffnen einer vorhandenen Datei ignoriert CreateFile2 diesen Parameter.

Beim Öffnen einer neuen verschlüsselten Datei erbt die Datei die diskretionäre Zugriffssteuerungsliste aus dem übergeordneten Verzeichnis. Weitere Informationen finden Sie unter Dateiverschlüsselung.

Hinweise

Um eine Anwendung zu kompilieren, die die CREATEFILE2_EXTENDED_PARAMETERS-Struktur verwendet, definieren Sie das _WIN32_WINNT Makro als 0x0602 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Cacheverhalten

Mehrere der möglichen Werte für den dwFileFlags-Member werden verwendet, um zu steuern oder zu beeinflussen, wie die dem Handle zugeordneten Daten vom System zwischengespeichert werden. Sie lauten wie folgt:

• FILE_FLAG_NO_BUFFERING
• FILE_FLAG_RANDOM_ACCESS
• FILE_FLAG_SEQUENTIAL_SCAN
• FILE_FLAG_WRITE_THROUGH
• FILE_ATTRIBUTE_TEMPORARY

Wenn keines dieser Flags angegeben ist, verwendet das System ein Standardschema für die allgemeine Zwischenspeicherung. Andernfalls verhält sich die Systemzwischenspeicherung wie für jedes Flag angegeben.

Einige dieser Flags sollten nicht kombiniert werden. Für instance ist die Kombination von FILE_FLAG_RANDOM_ACCESS mit FILE_FLAG_SEQUENTIAL_SCAN eine Selbstzerstörung.

Das Angeben des FILE_FLAG_SEQUENTIAL_SCAN-Flags kann die Leistung von Anwendungen erhöhen, die große Dateien mit sequenziellem Zugriff lesen. Noch deutlicher kann die Leistung bei Anwendungen sein, die große Dateien meist sequenziell lesen, aber gelegentlich über kleine Bytesbereiche überspringen. Wenn eine Anwendung den Dateizeiger für den zufälligen Zugriff verschiebt, tritt höchstwahrscheinlich keine optimale Zwischenspeicherungsleistung auf. Der korrekte Betrieb ist jedoch weiterhin garantiert.

Die Flags FILE_FLAG_WRITE_THROUGH und FILE_FLAG_NO_BUFFERING sind unabhängig und können kombiniert werden.

Wenn FILE_FLAG_WRITE_THROUGH verwendet wird, aber nicht auch FILE_FLAG_NO_BUFFERING angegeben wird, sodass die Systemzwischenspeicherung wirksam ist, werden die Daten in den Systemcache geschrieben, aber ohne Verzögerung auf den Datenträger geleert.

Wenn FILE_FLAG_WRITE_THROUGH und FILE_FLAG_NO_BUFFERING angegeben sind, sodass die Systemzwischenspeicherung nicht wirksam ist, werden die Daten sofort auf den Datenträger geleert, ohne den Windows-Systemcache zu durchlaufen. Das Betriebssystem fordert auch eine Durchschreibung des lokalen Hardwarecaches der Festplatte auf persistente Medien an.

Die ordnungsgemäße Verwendung des FILE_FLAG_NO_BUFFERING-Flags erfordert besondere Anwendungsüberlegungen. Weitere Informationen finden Sie unter Dateipufferung.

Eine Durchschreibanforderung über FILE_FLAG_WRITE_THROUGH bewirkt auch, dass NTFS alle Metadatenänderungen, z. B. eine Zeitstempelaktualisierung oder einen Umbenennungsvorgang, die sich aus der Verarbeitung der Anforderung ergeben, leert. Aus diesem Grund wird das FILE_FLAG_WRITE_THROUGH-Flag häufig mit dem FILE_FLAG_NO_BUFFERING-Flag als Ersatz für das Aufrufen der FlushFileBuffers-Funktion nach jedem Schreibvorgang verwendet, was zu unnötigen Leistungseinbußen führen kann. Wenn Sie diese Flags zusammen verwenden, werden diese Strafen vermieden. Allgemeine Informationen zum Zwischenspeichern von Dateien und Metadaten finden Sie unter Dateizwischenspeicherung.

Wenn FILE_FLAG_NO_BUFFERING mit FILE_FLAG_OVERLAPPED kombiniert wird, bieten die Flags maximale asynchrone Leistung, da die E/A-Vorgänge nicht von den synchronen Vorgängen des Speicher-Managers abhängig sind. Einige E/A-Vorgänge nehmen jedoch mehr Zeit in Anspruch, da die Daten nicht im Cache gespeichert werden. Außerdem können die Dateimetadaten weiterhin zwischengespeichert werden (z. B. beim Erstellen einer leeren Datei). Um sicherzustellen, dass die Metadaten auf den Datenträger geleert werden, verwenden Sie die FlushFileBuffers-Funktion .

Die Angabe des FILE_ATTRIBUTE_TEMPORARY-Attributs führt dazu, dass Dateisysteme das Zurückschreiben von Daten in den Massenspeicher vermeiden, wenn genügend Cachespeicher verfügbar ist, da eine Anwendung eine temporäre Datei löscht, nachdem ein Handle geschlossen wurde. In diesem Fall kann das System das Schreiben der Daten vollständig vermeiden. Obwohl die Datenzwischenspeicherung nicht direkt wie die zuvor erwähnten Flags gesteuert wird, weist das FILE_ATTRIBUTE_TEMPORARY-Attribut das System an, so viel wie möglich im Systemcache zu speichern, ohne zu schreiben, und kann daher für bestimmte Anwendungen von Bedenklich sein.

Synchrone und asynchrone E/A-Handles

CreateFile2 ermöglicht das Erstellen eines Datei- oder Gerätehandles, das entweder synchron oder asynchron ist. Ein synchrones Handle verhält sich so, dass E/A-Funktionsaufrufe mit diesem Handle blockiert werden, bis sie abgeschlossen sind, während ein asynchrones Dateihandle es ermöglicht, dass das System sofort von E/A-Funktionsaufrufen zurückgibt, unabhängig davon, ob er den E/A-Vorgang abgeschlossen hat oder nicht. Wie bereits erwähnt, wird dieses synchrone und asynchrone Verhalten bestimmt, indem FILE_FLAG_OVERLAPPED innerhalb des dwFileFlags-Members der CREATEFILE2_EXTENDED_PARAMETERS Struktur angegeben wird, die im pCreateExParams-Parameter übergeben wird. Bei der Verwendung asynchroner E/A-Vorgänge gibt es mehrere Komplexitäten und potenzielle Fallstricke; Weitere Informationen finden Sie unter Synchrone und asynchrone E/A.

Anforderungen

Weitere Informationen

CreateFile2

Strukturen in der Dateiverwaltung