Erzeugt oder öffnet eine Datei oder ein I/O-Gerät (Eingabegerät)

#include <WinAPIFiles.au3>
_WinAPI_CreateFileEx ( $sFilePath, $iCreation [, $iAccess = 0 [, $iShare = 0 [, $iFlagsAndAttributes = 0 [, $tSecurity = 0 [, $hTemplate = 0]]]]] )

Parameter

$sFilePath	Der Name der Datei oder des Gerätes welches erzeugt oder geöffnet werden soll.
$iCreation	Die Aktion welches auf die Datei oder das Gerät, welches existiert oder nicht, angewendet werden soll. Dieser Parameter muss einen der folgenden Wert annehmen und kann nich kombiniert werden.     $CREATE_NEW     $CREATE_ALWAYS     $OPEN_EXISTING     $OPEN_ALWAYS     $TRUNCATE_EXISTING
$iAccess	[optional] Der angeforderte Zugang zu der Datei oder dem Gerät welcher zusammengefasst werden kann als Lesen, Schreiben, beides oder keins davon (0) (Standard).     $GENERIC_READ     $GENERIC_WRITE     (Siehe MSDN für mehr Informationen)
$iShare	[optional] Der angeforderte Teilenmodus für die Datei oder das Gerät, welcher Lesen, Schreiben, Löschen, alle drei oder keins davon sein kann. Wenn dieser Parameter 0 ist (Standard) und _WinAPI_CreateFileEx() erfolgreich ist, so kann die Datei oder das Gerät nicht geteilt werden und nicht geöffnet werden bis das Handle zu der Datei oder dem Gerät geschlossen wurde.     $FILE_SHARE_DELETE     $FILE_SHARE_READ     $FILE_SHARE_WRITE
$iFlagsAndAttributes	[optional] Die Datei- oder Geräteattributen und Flags. Dieser Parameter kann einen der mehr der folgenden Werte annehmen:     $FILE_ATTRIBUTE_READONLY     $FILE_ATTRIBUTE_HIDDEN     $FILE_ATTRIBUTE_SYSTEM     $FILE_ATTRIBUTE_DIRECTORY     $FILE_ATTRIBUTE_ARCHIVE     $FILE_ATTRIBUTE_DEVICE     $FILE_ATTRIBUTE_NORMAL     $FILE_ATTRIBUTE_TEMPORARY     $FILE_ATTRIBUTE_SPARSE_FILE     $FILE_ATTRIBUTE_REPARSE_POINT     $FILE_ATTRIBUTE_COMPRESSED     $FILE_ATTRIBUTE_OFFLINE     $FILE_ATTRIBUTE_NOT_CONTENT_INDEXED     $FILE_ATTRIBUTE_ENCRYPTED     $FILE_FLAG_BACKUP_SEMANTICS     $FILE_FLAG_DELETE_ON_CLOSE     $FILE_FLAG_NO_BUFFERING     $FILE_FLAG_OPEN_NO_RECALL     $FILE_FLAG_OPEN_REPARSE_POINT     $FILE_FLAG_OVERLAPPED     $FILE_FLAG_POSIX_SEMANTICS     $FILE_FLAG_RANDOM_ACCESS     $FILE_FLAG_SEQUENTIAL_SCAN     $FILE_FLAG_WRITE_THROUGH     $SECURITY_ANONYMOUS (Standard)     $SECURITY_CONTEXT_TRACKING     $SECURITY_DELEGATION     $SECURITY_EFFECTIVE_ONLY     $SECURITY_IDENTIFICATION     $SECURITY_IMPERSONATION
$tSecurity	[optional] Die $tagSECURITY_ATTRIBUTES Struktur welche die zwei geteilten aber verwandten Datenmitglieder beinhaltet: Einen optionalen Sicherheitsdeskriptor und einen Boolean-Wert welcher angibt ob das zurückgegebene Handle von Childprozessen geerbt werden kann. Wenn dieser Parameter 0 ist (Standard), so kann das Handle von keinem Childprozess geerbt werden und die Anwendung kann die Datei oder das Gerät mit dem zurückgegebenen Handle erzeugen welches einen Standardsicherheitsdeskript erhält.
$hTemplate	[optional] Das Handle zu einer Vorlagendatei mit den $GENERIC_READ Zugangsrechten. Die Vorlagendatei liefert die Datenattribute und erweiterte Attribute für die Datei welche erzeugt werden soll.

Rückgabewert

Erfolg:	Handle zu der angegebenen Datei, dem Gerät, benannten Pipe oder einem Mail Slot.
Fehler:	0 und setzt das @error Flag auf ungleich null. @extended beinhaltet _WinAPI_GetLastError().

Bemerkungen

Wenn die Arbeit mit dem Objekthandle, welches von dieser Funktion zurückgegeben wurde, abgeschlossen ist, so sollte man sie mit der _WinAPI_CloseHandle() Funktion das Handle wieder schließen.
Dies gibt nicht nur Systemressourcen frei, sondern kann auch größeren Einfluss auf Dinge wie dem Teilen einer Datei, einem Gerät und dem Schreiben von Daten auf das Laufwerk haben.

Verwandte Funktionen

_WinAPI_CloseHandle

Siehe auch

Suche nach CreateFile in der MSDN Bibliothek.