CAtlTransactionManager-Klasse
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 |
|---|---|
| Schließ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
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 platzhalter Karte Zeichen 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, wird 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, wird 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, wird 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Einreichen und Feedback anzeigen für