CAtlTransactionManager::CreateFile

Erstellt oder öffnet eine Datei, einen Dateistream oder ein Verzeichnis als transaktiver Vorgang.

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

Parameter

• lpFileName
  Der Name eines erstellt sein bzw. Objekts geöffnet wurde.

• dwDesiredAccess
  Der Zugriff auf das Objekt, das als Lesen zusammengefasst werden kann, schreiben, oder keine (null).Die am häufigsten verwendeten Werte sind GENERIC_READ, GENERIC_WRITE oder beide: GENERIC_READ | GENERIC_WRITE.

• dwShareMode
  Der Freigabenmodus eines Objekts, das gelesen werden kann, beide, Lösch-, alle diese oder keine schreibt: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

• lpSecurityAttributes
  Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur, die eine optionale Sicherheitsbeschreibung und enthält auch, ob das zurückgegebene Handle durch untergeordnete Prozesse geerbt werden kann bestimmt.Der Parameter kann NULL sein.

• dwCreationDisposition
  Eine Aktion, auf Dateien erstellen, die vorhanden und nicht vorhanden sind.Dieser Parameter muss einer der folgenden Werte sein, die nicht kombiniert werden können: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING oder TRUNCATE_EXISTING.

• dwFlagsAndAttributes
  Die Dateiattribute und die Flags.Dieser Parameter kann eine beliebige Kombination der verfügbaren Dateiattribute (FILE_ATTRIBUTE_*) enthalten.Alle anderen Dateiattribute überschreiben FILE_ATTRIBUTE_NORMAL.Dieser Parameter kann Kombinationen von Flags (FILE_FLAG_*) für Steuerelement des Pufferungsverhaltens, der Zugriffsmodi und andere Flags enthalten auch für spezielle Zwecke.Diese kombinieren mit allen FILE_ATTRIBUTE_*-Werten.

• hTemplateFile
  Ein gültiges Handle für eine Vorlagendatei mit dem GENERIC_READ-Zugriffsrecht.Die Vorlagendatei stellt Dateiattribute und erweiterte Attribute für die Datei, die erstellt wird.Dieser Parameter kann NULL sein.

Rückgabewert

Gibt ein Handle zurück, das verwendet werden kann, um auf das Objekt zuzugreifen.

Hinweise

Dieser Wrapper ruft die CreateFileTransacted-Funktion auf.

Anforderungen

Header: atltransactionmanager.h

Siehe auch

Referenz

CAtlTransactionManager-Klasse