CAtlTransactionManager::CreateFile

Article
06/09/2015

Crée ou ouvre un fichier, un flux de fichiers, ou un répertoire comme opération traitée.

inline HANDLE CAtlTransactionManager::CreateFile(
   LPCTSTR lpFileName,
   DWORD dwDesiredAccess,
   DWORD dwShareMode,
   LPSECURITY_ATTRIBUTES lpSecurityAttributes,
   DWORD dwCreationDisposition,
   DWORD dwFlagsAndAttributes,
   HANDLE hTemplateFile
);

Paramètres

lpFileName
Le nom d'un objet à créer ou ouvrir.
dwDesiredAccess
L'accès à l'objet, qui peut être résumé comme lecture, écriture, ou aucun (zéro). Les valeurs les plus courantes sont GENERIC_READ, GENERIC_WRITE, ou les deux : GENERIC_READ | GENERIC_WRITE.
dwShareMode
Le mode de partage d'un objet, qui peut être lecture, écriture, les deux, suppression, toute ces derniers, ou none : 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.
lpSecurityAttributes
Un pointeur vers une structure de SECURITY_ATTRIBUTES qui contient un modèle facultatif de sécurité et également le détermine si le handle retourné peut être héritée par les processus enfant. Le paramètre peut être NULL.
dwCreationDisposition
Une action à effectuer les fichiers qui existent et n'existent pas. Ce paramètre doit être l'une des valeurs suivantes, qui ne peuvent pas être combinées : CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING, ou TRUNCATE_EXISTING.
dwFlagsAndAttributes
Les attributs de fichier et les balises. Ce paramètre peut inclure toute combinaison des attributs de fichier disponibles (FILE_ATTRIBUTE_*). Tous les autres attributs de fichier substituent FILE_ATTRIBUTE_NORMAL. Ce paramètre peut également contenir des combinaisons de balises (FILE_FLAG_*) pour le contrôle du comportement de mise en mémoire tampon, les modes d'accès, et d'autres balises pour un objectif particulier. Ceux-ci se combinent avec toutes les valeurs de FILE_ATTRIBUTE_*.
hTemplateFile
Un handle valide à un fichier modèle avec le droit d'accès de GENERIC_READ. Le fichier modèle fournit des attributs de fichier et les attributs étendus pour le fichier créé. Ce paramètre peut être NULL.

Valeur de retour

Retourne un handle qui peut être utilisé pour accéder à l'objet.

Notes

Ce wrapper appelle la fonction d' CreateFileTransacted .

Configuration requise

Header: atltransactionmanager.h

Voir aussi

Référence

CAtlTransactionManager, classe

Partager via