UDF > WinAPIEx > Files & Devices > Files >


_WinAPI_CreateFileEx

Cr�e ou ouvre un fichier ou un p�riph�rique d'E/S

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

Param�tres

$sFilePath Le nom du fichier ou du p�riph�rique � cr�er ou ouvrir.
$iCreation L'action � prendre pour un fichier ou un p�riph�rique qui existe ou n'existe pas. Ce param�tre doit �tre l'une des valeurs suivantes, qui ne peuvent pas �tre combin�s:
    $CREATE_NEW
    $CREATE_ALWAYS
    $OPEN_EXISTING
    $OPEN_ALWAYS
    $TRUNCATE_EXISTING
$iAccess [optionnel] L'acc�s requis au fichier ou au p�riph�rique, qui peut �tre r�sum� par lecture, �criture, les deux ou aucun (z�ro) (par d�faut).
    $GENERIC_READ
    $GENERIC_WRITE
    (Voir MSDN pour plus d'informations)
$iShare [optionnel] Le mode de partage requis du fichier ou du p�riph�rique, qui peut �tre lu, �crit, les deux � la fois, supprim�, tout � la fois, ou aucun.
Si ce param�tre est 0 (par d�faut) et que _WinAPI_CreateFileEx() r�ussit, le fichier ou le p�riph�rique ne peut pas �tre partag� et ne peut pas �tre � nouveau ouvert jusqu'� ce que le handle du fichier ou du p�riph�rique soit ferm�.
    $FILE_SHARE_DELETE
    $FILE_SHARE_READ
    $FILE_SHARE_WRITE
$iFlagsAndAttributes [optionnel] Les attributs et les flags du fichier ou du p�riph�rique. Ce param�tre peut prendre une ou plusieurs des valeurs suivantes:
    $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 (par d�faut)
    $SECURITY_CONTEXT_TRACKING
    $SECURITY_DELEGATION
    $SECURITY_EFFECTIVE_ONLY
    $SECURITY_IDENTIFICATION
    $SECURITY_IMPERSONATION
$tSecurity [optionnel] La structure $tagSECURITY_ATTRIBUTES qui contient deux membres de donn�es distincts mais li�s: un descripteur de s�curit� optionnel, et une valeur bool�enne qui d�termine si le handle retourn� peut �tre h�rit� par les processus enfants.
Si ce param�tre est 0 (par d�faut), le handle ne peut pas �tre h�rit� par un prcessus enfant et l'application peut cr�er le fichier ou le p�riph�rique associ� et avec le handle retourn� obtenir un descripteur de s�curit� par d�faut.
$hTemplate [optionnel] Le handle d'un fichier mod�le avec le droit d'acc�s $GENERIC_READ. Le fichier mod�le fournit les attributs et les attributs �tendus pour le fichier qui est en cours de cr�ation.

Valeur de retour

Succ�s: Retourne le handle du fichier, du p�riph�rique, du pipe nomm�, ou du mail slot sp�cifi�.
�chec: Retourne 0 et d�finit @error <> 0, @extended contient _WinAPI_GetLastError().

Remarque

Lorsqu'une application se termine en utilisant le handle de l'objet retourn� par cette fonction, utilisez la fonction _WinAPI_CloseHandle() pour fermer le handle.
Ceci, non seulement lib�re les ressources syst�me, mais peut avoir une influence plus large sur des choses comme le partage du fichier ou du p�riph�rique et la validation des donn�es du disque.

En relation

_WinAPI_CloseHandle

Voir aussi

Consultez CreateFile dans la librairie MSDN.