Freigeben über

CAtlTransactionManager-Klasse

  • Artikel

Die CAtlTransactionManager-Klasse stellt einen Wrapper für Kernel Transaction Manager (KTM)-Funktionen bereit.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

class CAtlTransactionManager;

Member

Öffentliche Konstruktoren

Name Beschreibung
~CAtlTransactionManager CAtlTransactionManager-Destruktor.
CAtlTransactionManager CAtlTransactionManager-Konstruktor.

Öffentliche Methoden

Name Beschreibung
Abschließen Schließt ein Transaktionshandle.
Commit Fordert an, dass die Transaktion zugesichert wird.
Erstellen Erstellt das Transaktionshandle.
CreateFile Erstellt oder öffnet eine Datei, einen Dateidatenstrom oder ein Verzeichnis als transacted-Vorgang.
DeleteFile Löscht eine vorhandene Datei als transacted-Vorgang.
FindFirstFile Durchsucht ein Verzeichnis nach einer Datei oder einem Unterverzeichnis als transacted-Vorgang.
GetFileAttributes Ruft Dateisystemattribute für eine angegebene Datei oder ein angegebenes Verzeichnis als transacted-Vorgang ab.
GetFileAttributesEx Ruft Dateisystemattribute für eine angegebene Datei oder ein angegebenes Verzeichnis als transacted-Vorgang ab.
GetHandle Gibt das Transaktionshandle zurück.
IsFallback Bestimmt, ob die Fallbackaufrufe aktiviert sind.
MoveFile Verschiebt eine vorhandene Datei oder ein Verzeichnis, einschließlich seiner untergeordneten Elemente, als transaktionenten Vorgang.
RegCreateKeyEx Erstellt den angegebenen Registrierungsschlüssel und ordnet ihn einer Transaktion zu. Wenn der Schlüssel bereits vorhanden ist, öffnet sie die Funktion.
RegDeleteKey Löscht einen Unterschlüssel und seine Werte aus der angegebenen plattformspezifischen Ansicht der Registrierung als transacted-Vorgang.
RegOpenKeyEx Öffnet den angegebenen Registrierungsschlüssel und ordnet ihn einer Transaktion zu.
Rollback Fordert an, dass die Transaktion zurückgesetzt wird.
SetFileAttributes Legt die Attribute für eine Datei oder ein Verzeichnis als transacted-Vorgang fest.

Geschützte Datenmember

Name Beschreibung
m_bFallback TRUE, wenn der Fallback unterstützt wird; Andernfalls FALSE.
m_hTransaction Der Transaktionshandle.

Hinweise

Vererbungshierarchie

ATL::CAtlTransactionManager

Anforderungen

Header: atltransactionmanager.h

~CAtlTransactionManager

CAtlTransactionManager-Destruktor.

virtual ~CAtlTransactionManager();

Hinweise

Bei der normalen Verarbeitung wird die Transaktion automatisch zugesichert und geschlossen. Wenn der Destruktor während eines Ausnahmeentspanns aufgerufen wird, wird die Transaktion zurückgesetzt und geschlossen.

CAtlTransactionManager

CAtlTransactionManager-Konstruktor.

CAtlTransactionManager(BOOL bFallback = TRUE, BOOL bAutoCreateTransaction = TRUE);

Parameter

bFallback
TRUE gibt den Supportfallback an. Wenn transacted-Funktion fehlschlägt, ruft die Klasse automatisch die Funktion "Nicht-Transaktionen" auf. FALSE gibt keine "Fallback"-Aufrufe an.

bAutoCreateTransaction
TRUE gibt an, dass der Transaktionshandler automatisch im Konstruktor erstellt wird. FALSE gibt an, dass es nicht ist.

Hinweise

Schließen

Schließt das Transaktionshandle.

inline BOOL Close();

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Dieser Wrapper ruft die CloseHandle Funktion auf. Die Methode wird automatisch im Destruktor aufgerufen.

Commit

Fordert an, dass die Transaktion zugesichert wird.

inline BOOL Commit();

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Dieser Wrapper ruft die CommitTransaction Funktion auf. Die Methode wird automatisch im Destruktor aufgerufen.

Erstellen

Erstellt das Transaktionshandle.

inline BOOL Create();

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Dieser Wrapper ruft die CreateTransaction Funktion auf. Überprüfen Sie dies auf

CreateFile

Erstellt oder öffnet eine Datei, einen Dateidatenstrom oder ein Verzeichnis als transacted-Vorgang.

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

Parameter

lpFileName
Der Name eines zu erstellenden oder geöffneten Objekts.

dwDesiredAccess
Der Zugriff auf das Objekt, das als Lese-, Schreib-, Schreib-, beides oder keines (Null) zusammengefasst werden kann. Die am häufigsten verwendeten Werte sind GENERIC_READ, GENERIC_WRITEoder beide: GENERIC_READ | GENERIC_WRITE.

dwShareMode
Der Freigabemodus eines Objekts, das gelesen, geschrieben, beide gelöscht werden kann, alle diese oder keine: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

lpSecurityAttributes
Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur, die einen optionalen Sicherheitsdeskriptor enthält, und bestimmt außerdem, ob der zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann. Der Parameter kann NULL sein.

dwCreationDisposition
Eine Aktion, die für dateien ausgeführt werden soll, die vorhanden sind 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 -flags. Dieser Parameter kann eine beliebige Kombination der verfügbaren Dateiattribute (FILE_ATTRIBUTE_*) enthalten. Alle anderen Dateiattribute überschreiben FILE_ATTRIBUTE_NORMAL. Dieser Parameter kann auch Kombinationen von Flags (FILE_FLAG_*) zum Steuern des Pufferverhaltens, Zugriffsmodi und anderen speziellen Flags enthalten. Diese werden mit allen FILE_ATTRIBUTE_*-Werten kombiniert.

hTemplateFile
Ein gültiger 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 für den Zugriff auf das Objekt verwendet werden kann.

Hinweise

Dieser Wrapper ruft die CreateFileTransacted Funktion auf.

DeleteFile

Löscht eine vorhandene Datei als transacted-Vorgang.

inline BOOL DeleteFile(LPCTSTR lpFileName);

Parameter

lpFileName
Der Name der zu löschenden Datei.

Hinweise

Dieser Wrapper ruft die DeleteFileTransacted Funktion auf.

FindFirstFile

Durchsucht ein Verzeichnis nach einer Datei oder einem Unterverzeichnis als transacted-Vorgang.

inline HANDLE FindFirstFile(
    LPCTSTR lpFileName,
    WIN32_FIND_DATA* pNextInfo);

Parameter

lpFileName
Das Verzeichnis oder der Pfad und der Dateiname, nach dem gesucht werden soll. Dieser Parameter kann Platzhalterzeichen enthalten, z. B. ein Sternchen (*) oder ein Fragezeichen ().

pNextInfo
Ein Zeiger auf die WIN32_FIND_DATA Struktur, die Informationen zu einer gefundenen Datei oder einem Unterverzeichnis empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf FindNextFile von oder FindClose. Wenn die Funktion fehlschlägt oder keine Dateien aus der Suchzeichenfolge im parameter lpFileName findet, wird der Rückgabewert INVALID_HANDLE_VALUE.

Hinweise

Dieser Wrapper ruft die FindFirstFileTransacted Funktion auf.

GetFileAttributes

Ruft Dateisystemattribute für eine angegebene Datei oder ein angegebenes Verzeichnis als transacted-Vorgang ab.

inline DWORD GetFileAttributes(LPCTSTR lpFileName);

Parameter

lpFileName
Der Name der Datei oder des Verzeichnisses.

Hinweise

Dieser Wrapper ruft die GetFileAttributesTransacted Funktion auf.

GetFileAttributesEx

Ruft Dateisystemattribute für eine angegebene Datei oder ein angegebenes Verzeichnis als transacted-Vorgang ab.

inline BOOL GetFileAttributesEx(
    LPCTSTR lpFileName,
    GET_FILEEX_INFO_LEVELS fInfoLevelId,
    LPVOID lpFileInformation);

Parameter

lpFileName
Der Name der Datei oder des Verzeichnisses.

fInfoLevelId
Die Ebene der abzurufenden Attributinformationen.

lpFileInformation
Ein Zeiger auf einen Puffer, der die Attributinformationen empfängt. Der Typ der Attributinformationen, die in diesem Puffer gespeichert werden, wird durch den Wert von fInfoLevelId bestimmt. Wenn der Parameter "fInfoLevelId " "GetFileExInfoStandard" lautet, verweist dieser Parameter auf eine WIN32_FILE_ATTRIBUTE_DATA Struktur.

Hinweise

Dieser Wrapper ruft die GetFileAttributesTransacted Funktion auf.

GetHandle

Gibt das Transaktionshandle zurück.

HANDLE GetHandle() const;

Rückgabewert

Gibt das Transaktionshandle für eine Klasse zurück. Gibt NULL zurück, wenn der CAtlTransactionManager Wert nicht an ein Handle angefügt ist.

Hinweise

IsFallback

Bestimmt, ob die Fallbackaufrufe aktiviert sind.

BOOL IsFallback() const;

Rückgabewert

Gibt WAHR zurück, wenn die Klasse Fallbackaufrufe unterstützt. Andernfalls FALSE.

Hinweise

m_bFallback

TRUE, wenn der Fallback unterstützt wird; Andernfalls FALSE.

BOOL m_bFallback;

Hinweise

m_hTransaction

Der Transaktionshandle.

HANDLE m_hTransaction;

Hinweise

MoveFile

Verschiebt eine vorhandene Datei oder ein Verzeichnis, einschließlich seiner untergeordneten Elemente, als transaktionenten Vorgang.

inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);

Parameter

lpOldFileName
Der aktuelle Name der vorhandenen Datei oder des verzeichnisses auf dem lokalen Computer.

lpNewFileName
Der neue Name für die Datei oder das Verzeichnis. Dieser Name darf nicht bereits vorhanden sein. Eine neue Datei befindet sich möglicherweise auf einem anderen Dateisystem oder Laufwerk. Ein neues Verzeichnis muss sich auf demselben Laufwerk befinden.

Hinweise

Dieser Wrapper ruft die MoveFileTransacted Funktion auf.

RegCreateKeyEx

Erstellt den angegebenen Registrierungsschlüssel und ordnet ihn einer Transaktion zu. Wenn der Schlüssel bereits vorhanden ist, öffnet sie die Funktion.

inline LSTATUS RegCreateKeyEx(
    HKEY hKey,
    LPCTSTR lpSubKey,
    DWORD dwReserved,
    LPTSTR lpClass,
    DWORD dwOptions,
    REGSAM samDesired,
    CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
    PHKEY phkResult,
    LPDWORD lpdwDisposition);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name eines Unterschlüssels, den diese Funktion öffnet oder erstellt.

dwReserved
Dieser Parameter ist reserviert und muss null sein.

lpClass
Die benutzerdefinierte Klasse dieses Schlüssels. Dieser Parameter kann ignoriert werden. Dieser Parameter kann NULL sein.

dwOptions
Dieser Parameter kann einer der folgenden Werte sein: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE oder REG_OPTION_VOLATILE.

samDesired
Eine Maske, die die Zugriffsrechte für den Schlüssel angibt.

lpSecurityAttributes
Zeiger auf eine SECURITY_ATTRIBUTES -Struktur, die bestimmt, ob das zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann. Wenn lpSecurityAttributes NULL ist, kann das Handle nicht geerbt werden.

phkResult
Ein Zeiger auf eine Variable, die ein Handle für den geöffneten oder erstellten Schlüssel empfängt. Wenn der Schlüssel nicht einer der vordefinierten Registrierungsschlüssel ist, rufen Sie die RegCloseKey Funktion auf, nachdem Sie die Verwendung des Handle abgeschlossen haben.

lpdwDisposition
Ein Zeiger auf eine Variable, die einen der folgenden Dispositionswerte empfängt: REG_CREATED_NEW_KEY oder REG_OPENED_EXISTING_KEY.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Hinweise

Dieser Wrapper ruft die RegCreateKeyTransacted Funktion auf.

RegDeleteKey

Löscht einen Unterschlüssel und seine Werte aus der angegebenen plattformspezifischen Ansicht der Registrierung als transacted-Vorgang.

inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name des zu löschenden Schlüssels.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Hinweise

Dieser Wrapper ruft die RegDeleteKeyTransacted Funktion auf.

RegOpenKeyEx

Öffnet den angegebenen Registrierungsschlüssel und ordnet ihn einer Transaktion zu.

inline LSTATUS RegOpenKeyEx(
    HKEY hKey,
    LPCTSTR lpSubKey,
    DWORD ulOptions,
    REGSAM samDesired,
    PHKEY phkResult);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name des Registrierungsunterschlüssels, der geöffnet werden soll.

ulOptions
Dieser Parameter ist reserviert und muss null sein.

samDesired
Eine Maske, die die Zugriffsrechte für den Schlüssel angibt.

phkResult
Ein Zeiger auf eine Variable, die ein Handle für den geöffneten oder erstellten Schlüssel empfängt. Wenn der Schlüssel nicht einer der vordefinierten Registrierungsschlüssel ist, rufen Sie die RegCloseKey Funktion auf, nachdem Sie die Verwendung des Handle abgeschlossen haben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Hinweise

Dieser Wrapper ruft die RegOpenKeyTransacted Funktion auf.

Rollback

Fordert an, dass die Transaktion zurückgesetzt wird.

inline BOOL Rollback();

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Dieser Wrapper ruft die RollbackTransaction Funktion auf.

SetFileAttributes

Legt die Attribute für eine Datei oder ein Verzeichnis als transacted-Vorgang fest.

inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);

Parameter

lpFileName
Der Name der Datei oder des Verzeichnisses.

dwAttributes
Die für die Datei festzulegenden Dateiattribute. Weitere Informationen finden Sie unter SetFileAttributesTransacted.

Hinweise

Dieser Wrapper ruft die SetFileAttributesTransacted Funktion auf.

Siehe auch

ATL-COM-Desktop-Komponenten