CreateFile2-Funktion (fileapi.h)

Artikel
08/23/2023

Erstellt oder öffnet eine Datei oder ein E/A-Gerät. Folgende E/A-Geräte werden am häufigsten verwendet: Datei, Dateistream, Verzeichnis, physischer Datenträger, Volume, Konsolenpuffer, Bandlaufwerk, Kommunikationsressource, Mailslot und Pipe. Die Funktion gibt ein Handle zurück, das für den Zugriff auf die Datei oder das Gerät für verschiedene E/A-Typen verwendet werden kann, abhängig von der Datei oder dem Gerät und den angegebenen Flags und Attributen.

Beim Aufruf von einer Windows Store-App wird CreateFile2 vereinfacht. Sie können nur Dateien oder Verzeichnisse in den Verzeichnissen ApplicationData.LocalFolder oder Package.InstalledLocation öffnen. Sie können keine Named Pipes oder Mailslots öffnen oder verschlüsselte Dateien (FILE_ATTRIBUTE_ENCRYPTED) erstellen.

Hinweis Wir beziehen uns hier auf den lokalen Ordner der App und den speicherort der Paketinstallation, nicht auf zusätzliche Pakete im Paketdiagramm, z. B. Ressourcenpakete. CreateFile2 unterstützt das Öffnen von Dateien in zusätzlichen Paketen im Paketgraphen nicht. Angenommen, eine App ist von WinJS abhängig. Die App kann CreateFile2 aufrufen, um eine Datei in ihrem Paket, aber nicht im WinJS-Paket zu öffnen.

Verwenden Sie die CreateFileTransacted-Funktion , um diesen Vorgang als transaktionierten Vorgang auszuführen, der zu einem Handle führt, das für transaktionsfähige E/A verwendet werden kann.

Syntax

HANDLE CreateFile2(
  [in]           LPCWSTR                           lpFileName,
  [in]           DWORD                             dwDesiredAccess,
  [in]           DWORD                             dwShareMode,
  [in]           DWORD                             dwCreationDisposition,
  [in, optional] LPCREATEFILE2_EXTENDED_PARAMETERS pCreateExParams
);

Parameter

[in] lpFileName

Der Name der Zu erstellenden oder zu öffnenden Datei oder des Geräts.

Informationen zu speziellen Gerätenamen finden Sie unter Definieren eines MS-DOS-Gerätenamens.

Geben Sie zum Erstellen eines Dateidatenstroms den Namen der Datei, einen Doppelpunkt und dann den Namen des Datenstroms an. Weitere Informationen finden Sie unter Dateistreams.

Tipp Ab Windows 10 Version 1607 können Sie die MAX_PATH-Einschränkung aufheben, ohne "\\?\" vorab ausstehen zu müssen. Ausführliche Informationen finden Sie im Abschnitt "Maximale Längenbeschränkung für Pfade" unter Benennen von Dateien, Pfaden und Namespaces .

[in] dwDesiredAccess

Der angeforderte Zugriff auf die Datei oder das Gerät, der als Lese-, Schreib-, Beides- oder Nullwerte zusammengefasst werden kann.

Die am häufigsten verwendeten Werte sind GENERIC_READ, GENERIC_WRITE oder beides (GENERIC_READ | GENERIC_WRITE). Weitere Informationen finden Sie unter Generische Zugriffsrechte, Dateisicherheit und Zugriffsrechte, Dateizugriffskonstanten und ACCESS_MASK.

Wenn dieser Parameter null ist, kann die Anwendung bestimmte Metadaten wie Datei-, Verzeichnis- oder Geräteattribute abfragen, ohne auf diese Datei oder das Gerät zuzugreifen, auch wenn GENERIC_READ Zugriff verweigert worden wäre.

Sie können keinen Zugriffsmodus anfordern, der in Konflikt mit dem Freigabemodus steht, der durch den dwShareMode-Parameter in einer geöffneten Anforderung angegeben wird, die bereits über ein geöffnetes Handle verfügt.

Weitere Informationen finden Sie im Abschnitt Hinweise dieses Themas und Erstellen und Öffnen von Dateien.

[in] dwShareMode

Der angeforderte Freigabemodus der Datei oder des Geräts, der gelesen, geschrieben, beide, gelöscht, alle oder keine (siehe folgende Tabelle) sein kann. Zugriffsanforderungen für Attribute oder erweiterte Attribute sind von diesem Flag nicht betroffen.

Wenn dieser Parameter null ist und CreateFile2 erfolgreich ist, kann die Datei oder das Gerät nicht freigegeben werden und kann erst wieder geöffnet werden, wenn das Handle für die Datei oder das Gerät geschlossen ist. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Sie können keinen Freigabemodus anfordern, der in Konflikt mit dem Zugriffsmodus steht, der in einer vorhandenen Anforderung mit einem geöffneten Handle angegeben ist. CreateFile2 schlägt fehl, und die GetLastError-Funktion gibt ERROR_SHARING_VIOLATION zurück.

Um einem Prozess die Freigabe einer Datei oder eines Geräts zu ermöglichen, während die Datei oder das Gerät in einem anderen Prozess geöffnet ist, verwenden Sie eine kompatible Kombination aus einem oder mehreren der folgenden Werte. Weitere Informationen zu gültigen Kombinationen dieses Parameters mit dem dwDesiredAccess-Parameter finden Sie unter Erstellen und Öffnen von Dateien.

Hinweis Die Freigabeoptionen für jedes geöffnete Handle bleiben in Kraft, bis dieses Handle geschlossen wird, unabhängig vom Prozesskontext.

Wert	Bedeutung
0 0x00000000	Verhindert, dass andere Prozesse eine Datei oder ein Gerät öffnen, wenn sie Lösch-, Lese- oder Schreibzugriff anfordern. Der exklusive Zugriff auf eine Datei oder ein Verzeichnis wird nur gewährt, wenn die Anwendung über Schreibzugriff auf die Datei verfügt.
FILE_SHARE_DELETE 0x00000004	Ermöglicht nachfolgende Geöffnete Vorgänge für eine Datei oder ein Gerät, um den Löschzugriff anzufordern. Andernfalls können andere Prozesse die Datei oder das Gerät nicht öffnen, wenn sie Löschzugriff anfordern. Wenn dieses Flag nicht angegeben ist, aber die Datei oder das Gerät für den Löschzugriff geöffnet wurde, schlägt die Funktion fehl. Hinweis Der Löschzugriff ermöglicht sowohl Lösch- als auch Umbenennungsvorgänge.
FILE_SHARE_READ 0x00000001	Ermöglicht nachfolgende Geöffnete Vorgänge für eine Datei oder ein Gerät, um Lesezugriff anzufordern. Andernfalls können andere Prozesse die Datei oder das Gerät nicht öffnen, wenn sie Lesezugriff anfordern. Wenn dieses Flag nicht angegeben ist, aber die Datei oder das Gerät für den Lesezugriff geöffnet wurde, schlägt die Funktion fehl. Wenn eine Datei oder ein Verzeichnis geöffnet wird und dieses Flag nicht angegeben wird und der Aufrufer keinen Schreibzugriff auf die Datei oder das Verzeichnis hat, schlägt die Funktion fehl.
FILE_SHARE_WRITE 0x00000002	Ermöglicht nachfolgende Geöffnete Vorgänge für eine Datei oder ein Gerät, um Schreibzugriff anzufordern. Andernfalls können andere Prozesse die Datei oder das Gerät nicht öffnen, wenn sie Schreibzugriff anfordern. Wenn dieses Flag nicht angegeben ist, aber die Datei oder das Gerät für den Schreibzugriff geöffnet wurde oder über eine Dateizuordnung mit Schreibzugriff verfügt, schlägt die Funktion fehl.

[in] dwCreationDisposition

Eine Aktion, die für eine Datei oder ein Gerät ausgeführt werden soll, die vorhanden ist oder nicht vorhanden ist.

Für andere Geräte als Dateien ist dieser Parameter in der Regel auf OPEN_EXISTING festgelegt.

Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Dieser Parameter muss einer der folgenden Werte sein, die nicht kombiniert werden können:

Wert	Bedeutung
CREATE_ALWAYS 2	Erstellt immer eine neue Datei. Wenn die angegebene Datei vorhanden und schreibbar ist, schneidet die Funktion die Datei ab, die Funktion ist erfolgreich, und der Code für den letzten Fehler ist auf ERROR_ALREADY_EXISTS (183) festgelegt. Wenn die angegebene Datei nicht vorhanden ist und ein gültiger Pfad ist, wird eine neue Datei erstellt, die Funktion ist erfolgreich, und der Letzte Fehlercode wird auf Null festgelegt. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
CREATE_NEW 1	Erstellt nur dann eine neue Datei, wenn sie noch nicht vorhanden ist. Wenn die angegebene Datei vorhanden ist, schlägt die Funktion fehl, und der Code für den letzten Fehler ist auf ERROR_FILE_EXISTS (80) festgelegt. Wenn die angegebene Datei nicht vorhanden ist und ein gültiger Pfad zu einem schreibbaren Speicherort ist, wird eine neue Datei erstellt.
OPEN_ALWAYS 4	Öffnet eine Datei immer. Wenn die angegebene Datei vorhanden ist, ist die Funktion erfolgreich, und der Code für den letzten Fehler wird auf ERROR_ALREADY_EXISTS (183) festgelegt. Wenn die angegebene Datei nicht vorhanden ist und ein gültiger Pfad zu einem schreibbaren Speicherort ist, erstellt die Funktion eine Datei, und der Letzte Fehlercode wird auf Null festgelegt.
OPEN_EXISTING 3	Öffnet eine Datei oder ein Gerät nur, wenn es vorhanden ist. Wenn die angegebene Datei oder das angegebene Gerät nicht vorhanden ist, schlägt die Funktion fehl, und der Letzte Fehlercode wird auf ERROR_FILE_NOT_FOUND (2) festgelegt. Weitere Informationen zu Geräten finden Sie im Abschnitt Hinweise.
TRUNCATE_EXISTING 5	Öffnet eine Datei und schneidet sie ab, sodass ihre Größe null Bytes beträgt, wenn sie vorhanden ist. Wenn die angegebene Datei nicht vorhanden ist, schlägt die Funktion fehl, und der Letzte Fehlercode ist auf ERROR_FILE_NOT_FOUND (2) festgelegt. Der aufrufende Prozess muss die Datei mit dem GENERIC_WRITE Bit öffnen, das als Teil des dwDesiredAccess-Parameters festgelegt ist.

[in, optional] pCreateExParams

Zeiger auf eine optionale CREATEFILE2_EXTENDED_PARAMETERS-Struktur .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein geöffnetes Handle für die angegebene Datei, das angegebene Gerät, die angegebene Named Pipe oder den angegebenen E-Mail-Slot.

Wenn die Funktion fehlschlägt, ist der Rückgabewert INVALID_HANDLE_VALUE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

CreateFile2 unterstützt die Dateiinteraktion und die meisten anderen Typen von E/A-Geräten und -Mechanismen, die Windows-Entwicklern zur Verfügung stehen. In diesem Abschnitt wird versucht, die verschiedenen Probleme zu behandeln, die Entwickler bei der Verwendung von CreateFile2 in verschiedenen Kontexten und mit unterschiedlichen E/A-Typen haben können. Der Text versucht, das Wort Datei nur zu verwenden, wenn er sich speziell auf Daten bezieht, die in einer tatsächlichen Datei in einem Dateisystem gespeichert sind. Einige Verwendungen von datei beziehen sich jedoch möglicherweise allgemeiner auf ein E/A-Objekt, das dateiähnliche Mechanismen unterstützt. Diese liberale Verwendung des Begriffs Datei ist aus den zuvor genannten historischen Gründen besonders bei Konstantennamen und Parameternamen verbreitet.

Wenn eine Anwendung das von CreateFile2 zurückgegebene Objekthandle verwendet hat, verwenden Sie die CloseHandle-Funktion , um das Handle zu schließen. Dies gibt nicht nur Systemressourcen frei, sondern kann auch einen größeren Einfluss auf Die Freigabe der Datei oder des Geräts und das Committen von Daten auf den Datenträger haben. Einzelheiten werden in diesem Thema nach Bedarf notiert.

Einige Dateisysteme, z. B. das NTFS-Dateisystem, unterstützen die Komprimierung oder Verschlüsselung für einzelne Dateien und Verzeichnisse. Auf Volumes, die über ein eingebundenes Dateisystem mit dieser Unterstützung verfügen, erbt eine neue Datei die Komprimierungs- und Verschlüsselungsattribute ihres Verzeichnisses.

Sie können CreateFile2 nicht verwenden, um die Komprimierung, Dekomprimierung oder Entschlüsselung für eine Datei oder ein Verzeichnis zu steuern. Weitere Informationen finden Sie unter Erstellen und Öffnen von Dateien, Dateikomprimierung und Dekomprimierung und Dateiverschlüsselung.

Wenn das lpSecurityAttributes-Element der CREATEFILE2_EXTENDED_PARAMETERS-Struktur , die im pCreateExParams-Parameter übergeben wird, NULL ist, kann das von CreateFile2 zurückgegebene Handle nicht von untergeordneten Prozessen geerbt werden, die Ihre Anwendung möglicherweise erstellt. Die folgenden Informationen zu diesem Mitglied gelten ebenfalls:

Wenn die bInheritHandle-Membervariable nicht FALSE ist, was ein beliebiger Wert ungleich null ist, kann das Handle geerbt werden. Daher ist es wichtig, dass dieser Strukturmember ordnungsgemäß mit FALSE initialisiert wird, wenn Sie nicht beabsichtigen, dass das Handle vererbbar ist.
Die Zugriffssteuerungslisten (Access Control Lists, ACL) in der Standardsicherheitsbeschreibung für eine Datei oder ein Verzeichnis werden vom übergeordneten Verzeichnis geerbt.
Das Zieldateisystem muss die Sicherheit von Dateien und Verzeichnissen unterstützen, damit der lpSecurityDescriptor-Member auswirkungen kann, was mithilfe von GetVolumeInformation bestimmt werden kann.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Verhalten symbolischer Verknüpfungen

Wenn der Aufruf dieser Funktion eine Datei erstellt, gibt es keine Verhaltensänderung. Beachten Sie auch die folgenden Informationen zu FILE_FLAG_OPEN_REPARSE_POINT Flag für den dwFileFlags-Member der CREATEFILE2_EXTENDED_PARAMETERS-Struktur , die im pCreateExParams-Parameter übergeben wird:

Wenn FILE_FLAG_OPEN_REPARSE_POINT angegeben ist:
- Wenn eine vorhandene Datei geöffnet wird und es sich um einen symbolischen Link handelt, ist das zurückgegebene Handle ein Handle für den symbolischen Link.
- Wenn TRUNCATE_EXISTING oder FILE_FLAG_DELETE_ON_CLOSE angegeben sind, ist die betroffene Datei ein symbolischer Link.
Wenn FILE_FLAG_OPEN_REPARSE_POINT nicht angegeben ist:
- Wenn eine vorhandene Datei geöffnet wird und es sich um einen symbolischen Link handelt, ist das zurückgegebene Handle ein Handle für das Ziel.
- Wenn CREATE_ALWAYS, TRUNCATE_EXISTING oder FILE_FLAG_DELETE_ON_CLOSE angegeben sind, ist die betroffene Datei das Ziel.

Dateien

Wenn Sie eine Datei umbenennen oder löschen und sie dann kurz danach wiederherstellen, durchsucht das System den Cache nach den wiederherzustellenden Dateiinformationen. Die zwischengespeicherten Informationen umfassen das Kurz-/Lange-Namenspaar und die Erstellungszeit.

Wenn Sie CreateFile2 für eine Datei aufrufen, die aufgrund eines vorherigen Aufrufs von DeleteFile gelöscht wird, schlägt die Funktion fehl. Das Betriebssystem verzögert das Löschen von Dateien, bis alle Handles für die Datei geschlossen sind. GetLastError gibt ERROR_ACCESS_DENIED zurück.

Der dwDesiredAccess-Parameter kann null sein, sodass die Anwendung Dateiattribute abfragen kann, ohne auf die Datei zuzugreifen, wenn die Anwendung mit angemessenen Sicherheitseinstellungen ausgeführt wird. Dies ist nützlich, um zu testen, ob eine Datei vorhanden ist, ohne sie für Lese- und/oder Schreibzugriff zu öffnen, oder um andere Statistiken über die Datei oder das Verzeichnis zu erhalten. Weitere Informationen finden Sie unter Abrufen und Festlegen von Dateiinformationen und GetFileInformationByHandle.

Wenn eine Anwendung eine Datei über ein Netzwerk erstellt, ist es besser, für dwDesiredAccess zu verwendenGENERIC_READ | GENERIC_WRITE, als GENERIC_WRITE allein zu verwenden. Der resultierende Code ist schneller, da der Redirector den Cache-Manager verwenden und weniger SMBs mit mehr Daten senden kann. Durch diese Kombination wird auch ein Problem vermieden, bei dem das Schreiben in eine Datei in einem Netzwerk gelegentlich ERROR_ACCESS_DENIED zurückgibt.

Weitere Informationen finden Sie unter Erstellen und Öffnen von Dateien.

Dateistreams

Auf NTFS-Dateisystemen können Sie CreateFile2 verwenden, um separate Streams innerhalb einer Datei zu erstellen. Weitere Informationen finden Sie unter Dateistreams.

Verzeichnisse

Eine Anwendung kann kein Verzeichnis mit CreateFile2 erstellen, daher ist für diesen Anwendungsfall nur der wert OPEN_EXISTING für dwCreationDisposition gültig. Um ein Verzeichnis zu erstellen, muss die Anwendung CreateDirectory oder CreateDirectoryEx aufrufen.

Um ein Verzeichnis mit CreateFile2 zu öffnen, geben Sie das FILE_FLAG_BACKUP_SEMANTICS-Flag als Teil des dwFileFlags-Elements der CREATEFILE2_EXTENDED_PARAMETERS-Struktur an, die im pCreateExParams-Parameter übergeben wird. Entsprechende Sicherheitsüberprüfungen gelten weiterhin, wenn dieses Flag ohne SE_BACKUP_NAME und SE_RESTORE_NAME Berechtigungen verwendet wird.

Wenn Sie CreateFile2 zum Öffnen eines Verzeichnisses während der Defragmentierung eines FAT- oder FAT32-Dateisystemvolumes verwenden, geben Sie nicht das MAXIMUM_ALLOWED-Zugriffsberechtigung an. Wenn dies der Fall ist, wird der Zugriff auf das Verzeichnis verweigert. Geben Sie stattdessen das GENERIC_READ Zugriffsrecht an.

Weitere Informationen finden Sie unter Informationen zur Verzeichnisverwaltung.

Physische Datenträger und Volumes

Der direkte Zugriff auf den Datenträger oder auf ein Volume ist eingeschränkt.

Sie können die CreateFile2-Funktion verwenden, um ein physisches Laufwerk oder ein Volume zu öffnen, das ein DASD-Handle (Direct Access Storage Device) zurückgibt, das mit der DeviceIoControl-Funktion verwendet werden kann. Dadurch können Sie direkt auf den Datenträger oder das Volume zugreifen, z. B. auf Datenträgermetadaten wie die Partitionstabelle. Dieser Zugriffstyp macht jedoch auch das Laufwerk oder das Volume potenziellen Datenverlusten aus, da ein falscher Schreibvorgang auf einen Datenträger mit diesem Mechanismus den Zugriff auf dessen Inhalt für das Betriebssystem unzugänglich machen könnte. Um die Datenintegrität sicherzustellen, sollten Sie sich mit DeviceIoControl vertraut machen und wie sich andere APIs mit einem direkten Zugriffshandle anders verhalten als mit einem Dateisystemhandle.

Die folgenden Anforderungen müssen erfüllt sein, damit ein solcher Aufruf erfolgreich ist:

Der Aufrufer muss über Administratorrechte verfügen. Weitere Informationen finden Sie unter Ausführen mit speziellen Berechtigungen.
Der dwCreationDisposition-Parameter muss über das flag OPEN_EXISTING verfügen.
Wenn Sie einen Volume- oder Diskettendatenträger öffnen, muss der dwShareMode-Parameter das flag FILE_SHARE_WRITE aufweisen.

Hinweis Der dwDesiredAccess-Parameter kann null sein, sodass die Anwendung Geräteattribute abfragen kann, ohne auf ein Gerät zuzugreifen. Dies ist nützlich für eine Anwendung, um die Größe eines Diskettenlaufwerks und die unterstützten Formate zu bestimmen, ohne dass eine Diskette in einem Laufwerk erforderlich ist, um instance. Sie kann auch zum Lesen von Statistiken verwendet werden, ohne dass die Lese-/Schreibberechtigung für Daten auf höherer Ebene erforderlich ist.

Beim Öffnen eines physischen Laufwerks x:, sollte die lpFileName-Zeichenfolge die folgende Form aufweisen: "\\.\PhysicalDriveX". Festplattennummern beginnen bei 0 (null). Die folgende Tabelle enthält einige Beispiele für physische Laufwerkszeichenfolgen.

String	Bedeutung
"\\.\PhysicalDrive0"	Öffnet das erste physische Laufwerk.
"\\.\PhysicalDrive2"	Öffnet das dritte physische Laufwerk.

Um den Bezeichner des physischen Laufwerks für ein Volume abzurufen, öffnen Sie ein Handle für das Volume, und rufen Sie die DeviceIoControl-Funktion mit IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS auf. Dieser Steuercode gibt die Datenträgernummer und den Offset für jede der Blöcke des Volumes zurück. Ein Volume kann mehrere physische Datenträger umfassen.

Ein Beispiel für das Öffnen eines physischen Laufwerks finden Sie unter Aufrufen von DeviceIoControl.

Beim Öffnen eines Volumes oder Wechselmedienlaufwerks (z. B. eines Diskettenlaufwerks oder eines Flash-Speicher-USB-Laufwerks) sollte die lpFileName-Zeichenfolge die folgende Form aufweisen: "\.\X:". Verwenden Sie keinen nachgestellten umgekehrten Schrägstrich (\), der das Stammverzeichnis eines Laufwerks angibt. Die folgende Tabelle enthält einige Beispiele für Laufwerkszeichenfolgen.

String	Bedeutung
"\\.\A:"	Öffnet Das Diskettenlaufwerk A.
"\\.\C:"	Öffnet das Volume C:
"\\.\C:\"	Öffnet das Dateisystem des Volumes C:

Sie können ein Volume auch öffnen, indem Sie auf seinen Volumenamen verweisen. Weitere Informationen finden Sie unter Benennen eines Volumes.

Ein Volume enthält mindestens ein eingebundenes Dateisystem. Volumehandles können im Ermessen des jeweiligen Dateisystems als nicht zwischengespeichert geöffnet werden, auch wenn die Option nicht zwischengespeichert in CreateFile2 nicht angegeben ist. Sie sollten davon ausgehen, dass alle offenen Microsoft-Dateisysteme das Volume als nicht zwischengespeichert behandeln. Die Einschränkungen für nicht zwischengespeicherte E/A für Dateien gelten auch für Volumes.

Ein Dateisystem erfordert möglicherweise eine Pufferausrichtung, obwohl die Daten nicht zwischengespeichert sind. Wenn beim Öffnen eines Volumes jedoch die Option ohne Zwischenspeicherung angegeben wird, wird die Pufferausrichtung unabhängig vom Dateisystem auf dem Volume erzwungen. Es wird empfohlen, für alle Dateisysteme, die Sie das Volume öffnen, als nicht zwischengespeichert zu behandeln und die nicht zwischengespeicherten E/A-Einschränkungen zu befolgen.

Hinweis Zum Lesen oder Schreiben in die letzten Sektoren des Volumes müssen Sie DeviceIoControl aufrufen und FSCTL_ALLOW_EXTENDED_DASD_IO angeben. Dies signalisiert dem Dateisystemtreiber, keine E/A-Begrenzungsprüfungen für Partitionsaufrufe mit Lese- oder Schreibzugriff durchzuführen. Stattdessen werden Begrenzungsprüfungen vom Gerätetreiber durchgeführt.

Veränderergerät

Die IOCTL_CHANGER_* -Steuerungscodes für DeviceIoControl akzeptieren ein Handle für ein Veränderergerät. Um ein Veränderergerät zu öffnen, verwenden Sie einen Dateinamen der folgenden Form: "\\.\Changerx", wobei x eine Zahl ist, die angibt, welches Gerät geöffnet werden soll, beginnend mit null. Um changer device zero in einer Anwendung zu öffnen, die in C oder C++ geschrieben ist, verwenden Sie den folgenden Dateinamen: "\\\\.\Changer0".

Bandlaufwerke

Sie können Bandlaufwerke öffnen, indem Sie einen Dateinamen der folgenden Form verwenden: "\\.\TAPEx", wobei x eine Zahl ist, die angibt, welches Laufwerk geöffnet werden soll, beginnend mit Bandlaufwerk 0. Um bandlaufwerk null in einer Anwendung zu öffnen, die in C oder C++ geschrieben ist, verwenden Sie den folgenden Dateinamen: "\\\.\\TAPE0".

Weitere Informationen finden Sie unter Sicherung.

Kommunikationsressourcen

Die CreateFile2-Funktion kann ein Handle für eine Kommunikationsressource wie den seriellen Port COM1 erstellen. Für Kommunikationsressourcen muss der dwCreationDisposition-ParameterOPEN_EXISTING, der dwShareMode-Parameter 0 (exklusiver Zugriff) und der hTemplateFile-ParameterNULL sein. Lese-, Schreib- oder Lese-/Schreibzugriff kann angegeben werden, und das Handle kann für überlappende E/A-Vorgänge geöffnet werden.

Um eine COM-Portnummer größer als 9 anzugeben, verwenden Sie die folgende Syntax: "\.\COM10". Diese Syntax funktioniert für alle Portnummern und Hardware, die die Angabe von COM-Portnummern ermöglicht.

Weitere Informationen zur Kommunikation finden Sie unter Kommunikation.

Konsolen

Die CreateFile2-Funktion kann ein Handle to Console Input (CONIN$) erstellen. Wenn der Prozess aufgrund von Vererbung oder Duplizierung über ein geöffnetes Handle verfügt, kann er auch ein Handle für den aktiven Bildschirmpuffer (CONOUT$) erstellen. Der aufrufende Prozess muss an eine geerbte oder von der Funktion AllocConsole zugewiesene Konsole angefügt werden. Legen Sie für Konsolenhandles die CreateFile2-Parameter wie folgt fest.

Parameter	Wert
lpFileName	Verwenden Sie den CONIN$-Wert, um die Konsoleneingabe anzugeben. Verwenden Sie den CONOUT$-Wert, um die Konsolenausgabe anzugeben. CONIN$ ruft ein Handle an den Konsoleneingabepuffer ab, auch wenn die SetStdHandle-Funktion das Standardeingabehandle umleitet. Verwenden Sie zum Abrufen des Standardeingabehandles die GetStdHandle-Funktion . CONOUT$ erhält ein Handle an den aktiven Bildschirmpuffer, auch wenn SetStdHandle das Standardausgabehandle umleitet. Verwenden Sie GetStdHandle, um das Standardausgabehandle abzurufen.
dwDesiredAccess	`GENERIC_READ \| GENERIC_WRITE` wird bevorzugt, aber beide können den Zugriff einschränken.
dwShareMode	Geben Sie beim Öffnen von CONIN$ FILE_SHARE_READ an. Geben Sie beim Öffnen von CONOUT$ FILE_SHARE_WRITE an. Wenn der aufrufende Prozess die Konsole erbt oder ein untergeordneter Prozess auf die Konsole zugreifen kann, muss dieser Parameter lauten `FILE_SHARE_READ \| FILE_SHARE_WRITE`.
dwCreationDisposition	Sie sollten OPEN_EXISTING angeben, wenn Sie CreateFile2 zum Öffnen der Konsole verwenden.

Legen Sie die Elemente der CREATEFILE2_EXTENDED_PARAMETERS-Struktur fest, die im pCreateExParams-Parameter übergeben wird, wie folgt.

Member	Wert
lpSecurityAttributes	Wenn die Konsole geerbt werden soll, muss das bInheritHandle-Element der SECURITY_ATTRIBUTES-StrukturTRUE sein.
dwFileAttributes dwFileFlags dwSecurityQosFlags hTemplateFile	Ignoriert.

Member

Wert

lpSecurityAttributes

Wenn die Konsole geerbt werden soll, muss das bInheritHandle-Element der SECURITY_ATTRIBUTES-StrukturTRUE sein.

dwFileAttributes

dwFileFlags

dwSecurityQosFlags

hTemplateFile

Ignoriert.

Die folgende Tabelle zeigt verschiedene Einstellungen von dwDesiredAccess und lpFileName.

lpFileName	dwDesiredAccess	Ergebnis
"CON"	GENERIC_READ	Öffnet die Konsole für die Eingabe.
"CON"	GENERIC_WRITE	Öffnet die Konsole für die Ausgabe.
"CON"	`GENERIC_READ \| GENERIC_WRITE`	Führt dazu , dass CreateFile2 fehlschlägt; GetLastError gibt ERROR_FILE_NOT_FOUND zurück.

Mailslots

Wenn CreateFile2 das Clientende eines Maillots öffnet, gibt die Funktion INVALID_HANDLE_VALUE zurück, wenn der maillot-Client versucht, ein lokales Maillot zu öffnen, bevor der maillot-Server es mit der CreateMailSlot-Funktion erstellt hat.

Weitere Informationen finden Sie unter Mailslots.

Rohre

Wenn CreateFile2 das Clientende einer Named Pipe öffnet, verwendet die Funktion eine beliebige instance der benannten Pipe, die sich im Lauschzustand befindet. Der Öffnungsprozess kann das Handle so oft wie erforderlich duplizieren, aber nach dem Öffnen kann die benannte Pipe instance nicht von einem anderen Client geöffnet werden. Der Zugriff, der beim Öffnen einer Pipe angegeben wird, muss mit dem Zugriff kompatibel sein, der im dwOpenMode-Parameter der CreateNamedPipe-Funktion angegeben ist.

Wenn die CreateNamedPipe-Funktion auf dem Server vor diesem Vorgang nicht erfolgreich aufgerufen wurde, ist keine Pipe vorhanden, und CreateFile2 schlägt mit ERROR_FILE_NOT_FOUND fehl.

Wenn mindestens eine aktive Pipe instance vorhanden ist, aber keine Listenerpipes auf dem Server verfügbar sind, was bedeutet, dass alle Pipeinstanzen derzeit verbunden sind, schlägt CreateFile2 mit ERROR_PIPE_BUSY fehl.

Weitere Informationen finden Sie unter Pipes.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll