CAtlTransactionManager – třída
CAtlTransactionManager třída poskytuje obálku funkcíM Kernel Transaction Manager (KTM).
Důležité
Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.
Syntaxe
class CAtlTransactionManager;
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| ~CAtlTransactionManager | CAtlTransactionManager destructor. |
| CAtlTransactionManager | CAtlTransactionManager konstruktor. |
Veřejné metody
| Název | Popis |
|---|---|
| Zavřít | Zavře jeden popisovač transakce. |
| Spáchat | Vyžaduje, aby transakce byla potvrzena. |
| Vytvořit | Vytvoří popisovač transakce. |
| CreateFile | Vytvoří nebo otevře soubor, datový proud souboru nebo adresář jako transactovanou operaci. |
| DeleteFile | Odstraní existující soubor jako transactovanou operaci. |
| FindFirstFile | Vyhledá v adresáři soubor nebo podadresář jako transactovanou operaci. |
| GetFileAttributes | Načte atributy systému souborů pro zadaný soubor nebo adresář jako transactovanou operaci. |
| GetFileAttributesEx | Načte atributy systému souborů pro zadaný soubor nebo adresář jako transactovanou operaci. |
| GetHandle | Vrátí popisovač transakce. |
| IsFallback | Určuje, jestli jsou povolená náhradní volání. |
| MoveFile | Přesune existující soubor nebo adresář, včetně podřízených položek, jako transakce. |
| RegCreateKeyEx | Vytvoří zadaný klíč registru a přidruží ho k transakci. Pokud klíč již existuje, funkce ji otevře. |
| RegDeleteKey | Odstraní podklíč a jeho hodnoty ze zadaného zobrazení registru specifického pro platformu jako transakce. |
| RegOpenKeyEx | Otevře zadaný klíč registru a přidruží ho k transakci. |
| Redukce | Vyžaduje vrácení transakce zpět. |
| SetFileAttributes | Nastaví atributy souboru nebo adresáře jako transakce. |
Chráněné datové členy
| Název | Popis |
|---|---|
| m_bFallback | TRUE, pokud je podporován náhradní; JINAK NEPRAVDA. |
| m_hTransaction | Popisovač transakce. |
Poznámky
Hierarchie dědičnosti
Požadavky
Hlavička: atltransactionmanager.h
~CAtlTransactionManager
CAtlTransactionManager destructor.
virtual ~CAtlTransactionManager();
Poznámky
V normálním zpracování je transakce automaticky potvrzena a uzavřena. Pokud je destruktor volána během uvolnění výjimky, transakce se vrátí zpět a zavře.
CAtlTransactionManager
CAtlTransactionManager konstruktor.
CAtlTransactionManager(BOOL bFallback = TRUE, BOOL bAutoCreateTransaction = TRUE);
Parametry
bFallback
HODNOTA TRUE označuje podporu náhradní lokality. Pokud transacted funkce selže, třída automaticky volá "non-transacted" funkce. NEPRAVDA označuje žádná volání typu "náhradní".
bAutoCreateTransaction
PRAVDA označuje, že obslužná rutina transakce je vytvořena automaticky v konstruktoru. NEPRAVDA označuje, že není.
Poznámky
Zavřít
Zavře popisovač transakce.
inline BOOL Close();
Návratová hodnota
TRUE v případě úspěchu; jinak NEPRAVDA.
Poznámky
Tento obálka CloseHandle volá funkci. Metoda se automaticky volá v destruktoru.
Potvrzení
Vyžaduje, aby transakce byla potvrzena.
inline BOOL Commit();
Návratová hodnota
TRUE v případě úspěchu; jinak NEPRAVDA.
Poznámky
Tento obálka CommitTransaction volá funkci. Metoda se automaticky volá v destruktoru.
Vytvoření
Vytvoří popisovač transakce.
inline BOOL Create();
Návratová hodnota
TRUE v případě úspěchu; jinak NEPRAVDA.
Poznámky
Tento obálka CreateTransaction volá funkci. Zkontrolujte, jestli není
CreateFile
Vytvoří nebo otevře soubor, datový proud souboru nebo adresář jako transactovanou operaci.
inline HANDLE CreateFile(
LPCTSTR lpFileName,
DWORD dwDesiredAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDisposition,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile);
Parametry
lpFileName
Název objektu, který se má vytvořit nebo otevřít.
dwDesiredAccess
Přístup k objektu, který lze shrnout jako čtení, zápis, obojí nebo ani jedno (nula). Nejčastěji používané hodnoty jsou GENERIC_READ, GENERIC_WRITEnebo obojí: GENERIC_READ | GENERIC_WRITE.
dwShareMode
Režim sdílení objektu, který může být přečtený, zapisovat, oba, odstranit, všechny tyto nebo žádné: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.
lpSecurityAttributes
Ukazatel na SECURITY_ATTRIBUTES strukturu, která obsahuje volitelný popisovač zabezpečení a také určuje, zda vrácený popisovač lze dědit podřízenými procesy. Parametr může mít hodnotu NULL.
dwCreationDisposition
Akce, která se má provést u souborů, které existují a neexistují. Tento parametr musí být jedna z následujících hodnot, které nelze kombinovat: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING nebo TRUNCATE_EXISTING.
dwFlagsAndAttributes
Atributy a příznaky souboru. Tento parametr může obsahovat libovolnou kombinaci dostupných atributů souboru (FILE_ATTRIBUTE_*). Všechny ostatní atributy souboru přepíší FILE_ATTRIBUTE_NORMAL. Tento parametr může také obsahovat kombinace příznaků (FILE_FLAG_*) pro řízení chování ukládání do vyrovnávací paměti, režimů přístupu a dalších příznaků pro zvláštní účely. Tyto hodnoty se kombinují s libovolnými hodnotami FILE_ATTRIBUTE_*.
hTemplateFile
Platný popisovač souboru šablony s GENERIC_READ přístupové právo. Soubor šablony poskytuje atributy souboru a rozšířené atributy pro soubor, který se vytváří. Tento parametr může mít hodnotu NULL.
Návratová hodnota
Vrátí popisovač, který lze použít pro přístup k objektu.
Poznámky
Tento obálka CreateFileTransacted volá funkci.
DeleteFile
Odstraní existující soubor jako transactovanou operaci.
inline BOOL DeleteFile(LPCTSTR lpFileName);
Parametry
lpFileName
Název souboru, který se má odstranit.
Poznámky
Tento obálka DeleteFileTransacted volá funkci.
FindFirstFile
Vyhledá v adresáři soubor nebo podadresář jako transactovanou operaci.
inline HANDLE FindFirstFile(
LPCTSTR lpFileName,
WIN32_FIND_DATA* pNextInfo);
Parametry
lpFileName
Adresář nebo cesta a název souboru, který chcete vyhledat. Tento parametr může obsahovat zástupné znaky, například hvězdičku (*) nebo otazník ().
pNextInfo
Ukazatel na WIN32_FIND_DATA strukturu, která přijímá informace o nalezeném souboru nebo podadresáři.
Návratová hodnota
Pokud je funkce úspěšná, návratová hodnota je vyhledávací popisovač použitý při následném volání FindNextFile nebo FindClose. Pokud funkce selže nebo se nepodaří vyhledat soubory z vyhledávacího řetězce v parametru lpFileName , návratová hodnota je INVALID_HANDLE_VALUE.
Poznámky
Tento obálka FindFirstFileTransacted volá funkci.
GetFileAttributes
Načte atributy systému souborů pro zadaný soubor nebo adresář jako transactovanou operaci.
inline DWORD GetFileAttributes(LPCTSTR lpFileName);
Parametry
lpFileName
Název souboru nebo adresáře.
Poznámky
Tento obálka GetFileAttributesTransacted volá funkci.
GetFileAttributesEx
Načte atributy systému souborů pro zadaný soubor nebo adresář jako transactovanou operaci.
inline BOOL GetFileAttributesEx(
LPCTSTR lpFileName,
GET_FILEEX_INFO_LEVELS fInfoLevelId,
LPVOID lpFileInformation);
Parametry
lpFileName
Název souboru nebo adresáře.
fInfoLevelId
Úroveň informací o atributu, které se mají načíst.
lpFileInformation
Ukazatel na vyrovnávací paměť, která přijímá informace o atributu. Typ informací o atributu uložených v této vyrovnávací paměti je určen hodnotou fInfoLevelId. Pokud je parametr fInfoLevelId GetFileExInfoStandard, tento parametr odkazuje na WIN32_FILE_ATTRIBUTE_DATA strukturu.
Poznámky
Tento obálka GetFileAttributesTransacted volá funkci.
GetHandle
Vrátí popisovač transakce.
HANDLE GetHandle() const;
Návratová hodnota
Vrátí popisovač transakce pro třídu. Vrátí hodnotu NULL, pokud CAtlTransactionManager není připojen k popisovači.
Poznámky
IsFallback
Určuje, jestli jsou povolená náhradní volání.
BOOL IsFallback() const;
Návratová hodnota
Vrátí hodnotu PRAVDA je třída podporuje záložní volání. JINAK NEPRAVDA.
Poznámky
m_bFallback
TRUE, pokud je podporován náhradní; JINAK NEPRAVDA.
BOOL m_bFallback;
Poznámky
m_hTransaction
Popisovač transakce.
HANDLE m_hTransaction;
Poznámky
MoveFile
Přesune existující soubor nebo adresář, včetně podřízených položek, jako transakce.
inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);
Parametry
lpOldFileName
Aktuální název existujícího souboru nebo adresáře v místním počítači.
lpNewFileName
Nový název souboru nebo adresáře. Tento název již nesmí existovat. Nový soubor může být v jiném systému souborů nebo jednotce. Nový adresář musí být na stejné jednotce.
Poznámky
Tento obálka MoveFileTransacted volá funkci.
RegCreateKeyEx
Vytvoří zadaný klíč registru a přidruží ho k transakci. Pokud klíč již existuje, funkce ji otevře.
inline LSTATUS RegCreateKeyEx(
HKEY hKey,
LPCTSTR lpSubKey,
DWORD dwReserved,
LPTSTR lpClass,
DWORD dwOptions,
REGSAM samDesired,
CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
PHKEY phkResult,
LPDWORD lpdwDisposition);
Parametry
hKey
Popisovač otevřeného klíče registru.
lpSubKey
Název podklíče, který tato funkce otevře nebo vytvoří.
dwReserved
Tento parametr je rezervovaný a musí být nulový.
lpClass
Uživatelsky definovaná třída tohoto klíče. Tento parametr může být ignorován. Tento parametr může mít hodnotu NULL.
dwOptions
Tento parametr může být jedna z následujících hodnot: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE nebo REG_OPTION_VOLATILE.
samDesired
Maska, která určuje přístupová práva pro klíč.
lpSecurityAttributes
Ukazatel na SECURITY_ATTRIBUTES strukturu, která určuje, zda vrácený popisovač lze dědit podřízenými procesy. Pokud má atribut lpSecurityAttributes hodnotu NULL, popisovač nelze zdědit.
PhkResult
Ukazatel na proměnnou, která přijímá popisovač otevřeného nebo vytvořeného klíče. Pokud klíč není jedním z předdefinovaných klíčů registru, zavolejte RegCloseKey funkci po dokončení pomocí popisovače.
lpdwDisposition
Ukazatel na proměnnou, která přijímá jednu z následujících hodnot dispozice: REG_CREATED_NEW_KEY nebo REG_OPENED_EXISTING_KEY.
Návratová hodnota
Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.
Poznámky
Tento obálka RegCreateKeyTransacted volá funkci.
RegDeleteKey
Odstraní podklíč a jeho hodnoty ze zadaného zobrazení registru specifického pro platformu jako transakce.
inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);
Parametry
hKey
Popisovač otevřeného klíče registru.
lpSubKey
Název klíče, který se má odstranit.
Návratová hodnota
Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.
Poznámky
Tento obálka RegDeleteKeyTransacted volá funkci.
RegOpenKeyEx
Otevře zadaný klíč registru a přidruží ho k transakci.
inline LSTATUS RegOpenKeyEx(
HKEY hKey,
LPCTSTR lpSubKey,
DWORD ulOptions,
REGSAM samDesired,
PHKEY phkResult);
Parametry
hKey
Popisovač otevřeného klíče registru.
lpSubKey
Název podklíče registru, který se má otevřít.
UlOptions
Tento parametr je rezervovaný a musí být nulový.
samDesired
Maska, která určuje přístupová práva pro klíč.
PhkResult
Ukazatel na proměnnou, která přijímá popisovač otevřeného nebo vytvořeného klíče. Pokud klíč není jedním z předdefinovaných klíčů registru, zavolejte RegCloseKey funkci po dokončení pomocí popisovače.
Návratová hodnota
Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.
Poznámky
Tento obálka RegOpenKeyTransacted volá funkci.
Vrácení zpět
Vyžaduje vrácení transakce zpět.
inline BOOL Rollback();
Návratová hodnota
TRUE v případě úspěchu; jinak NEPRAVDA.
Poznámky
Tento obálka RollbackTransaction volá funkci.
SetFileAttributes
Nastaví atributy souboru nebo adresáře jako transakce.
inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);
Parametry
lpFileName
Název souboru nebo adresáře.
dwAttributes
Atributy souboru, které se mají nastavit pro soubor. Další informace naleznete v tématu SetFileAttributesTransacted.
Poznámky
Tento obálka SetFileAttributesTransacted volá funkci.