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_READ|針對 .

  • 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 類別