CAtlTransactionManager::CreateFile

创建或打开一个文件流、文件或目录为已处理的操作。

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

参数

  • lpFileName
    将创建或打开的对象的名称。

  • dwDesiredAccess
    对对象的访问,可以总结为读取,编写,或关闭和/或(0)。 最常用的值是GENERIC_READ,GENERIC_WRITE或两个:GENERIC_READ|GENERIC_WRITE.

  • dwShareMode
    对象的共享的模式,可以读取,编写,两者,删除,所有这些或任何:0,FILE_SHARE_DELETE,FILE_SHARE_READ,FILE_SHARE_WRITE。

  • lpSecurityAttributes
    对包含可选安全说明符并SECURITY_ATTRIBUTES结构的指针确定返回的句柄是否可由子进程继承。 该参数可以是 NULL。

  • dwCreationDisposition
    公认的事件存在并且不存在的文件。 此参数必须是下列值之一,则无法合并:CREATE_ALWAYS、CREATE_NEW、OPEN_ALWAYS、OPEN_EXISTING或TRUNCATE_EXISTING。

  • dwFlagsAndAttributes
    文件属性和标志。 此参数可以包括可用文件属性(FILE_ATTRIBUTE_*)的任意组合。 其他文件属性重写FILE_ATTRIBUTE_NORMAL。 此参数也许还包含标志(FILE_FLAG_*)的组合缓冲区行为、访问模式和其他私有标志来控制的。 这些合并与任何FILE_ATTRIBUTE_*值。

  • hTemplateFile
    对一个模板文件的有效句柄与GENERIC_READ访问权限。 模板文件提供文件属性和扩展属性创建文件的。 此参数可以为 NULL。

返回值

返回可用于访问对象的句柄。

备注

此包装调用 CreateFileTransacted 功能。

要求

Header: atltransactionmanager.h

请参见

参考

CAtlTransactionManager选件类