CAtlTransactionManager-klasse

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

CAtlTransactionManager-klasse biedt een wrapper naar KTM-functies (Kernel Transaction Manager).

Belangrijk

Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Syntaxis

class CAtlTransactionManager;

Leden

Openbare constructors

Naam	Description
~CAtlTransactionManager	CAtlTransactionManager destructor.
CAtlTransactionManager	CAtlTransactionManager-constructor.

Openbare methoden

Naam	Description
sluiten	Hiermee sluit u een transactiehandler.
Doorvoeren	Vraagt of de transactie wordt doorgevoerd.
Creëren	Hiermee maakt u de transactie-handle.
CreateFile	Hiermee maakt of opent u een bestand, bestandsstroom of map als een transacted bewerking.
DeleteFile	Hiermee verwijdert u een bestaand bestand als een transacted bewerking.
FindFirstFile	Zoekt in een map naar een bestand of submap als een transacted bewerking.
GetFileAttributes	Haalt kenmerken van het bestandssysteem voor een opgegeven bestand of map op als een transacted bewerking.
GetFileAttributesEx	Haalt kenmerken van het bestandssysteem voor een opgegeven bestand of map op als een transacted bewerking.
GetHandle	Retourneert de transactie-handle.
IsFallback	Bepaalt of de terugvalaanroepen zijn ingeschakeld.
MoveFile	Hiermee verplaatst u een bestaand bestand of een map, inclusief de onderliggende items, als een transacted bewerking.
RegCreateKeyEx	Hiermee maakt u de opgegeven registersleutel en koppelt u deze aan een transactie. Als de sleutel al bestaat, wordt deze door de functie geopend.
RegDeleteKey	Hiermee verwijdert u een subsleutel en de bijbehorende waarden uit de opgegeven platformspecifieke weergave van het register als een transacted bewerking.
RegOpenKeyEx	Hiermee opent u de opgegeven registersleutel en koppelt u deze aan een transactie.
Terugdraaien	Aanvragen dat de transactie wordt teruggedraaid.
SetFileAttributes	Hiermee stelt u de kenmerken voor een bestand of map in als een transacted bewerking.

Beveiligde gegevensleden

Naam	Description
m_bFallback	WAAR als de terugval wordt ondersteund; ANDERS ONWAAR.
m_hTransaction	De transactiehandler.

Opmerkingen

Overnamehiërarchie

ATL::CAtlTransactionManager

Requirements

Header: atltransactionmanager.h

~CAtlTransactionManager

CAtlTransactionManager destructor.

virtual ~CAtlTransactionManager();

Opmerkingen

Bij normale verwerking wordt de transactie automatisch doorgevoerd en gesloten. Als de destructor wordt aangeroepen tijdens een uitzondering, wordt de transactie teruggedraaid en gesloten.

CAtlTransactionManager

CAtlTransactionManager-constructor.

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

Parameterwaarden

bFallback
TRUE geeft ondersteuningsback aan. Als de transacted-functie mislukt, roept de klasse automatisch de functie 'niet-transacted' aan. FALSE geeft geen terugvalaanroepen aan.

bAutoCreateTransaction
TRUE geeft aan dat de transactiehandler automatisch wordt gemaakt in de constructor. FALSE geeft aan dat dit niet het is.

Opmerkingen

Close

Hiermee sluit u de transactie-ingang.

inline BOOL Close();

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

Met deze wrapper wordt de CloseHandle functie aangeroepen. De methode wordt automatisch aangeroepen in de destructor.

Verplichten

Vraagt of de transactie wordt doorgevoerd.

inline BOOL Commit();

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

Met deze wrapper wordt de CommitTransaction functie aangeroepen. De methode wordt automatisch aangeroepen in de destructor.

Create

Hiermee maakt u de transactie-handle.

inline BOOL Create();

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

Met deze wrapper wordt de CreateTransaction functie aangeroepen. Controleer het op

CreateFile

Hiermee maakt of opent u een bestand, bestandsstroom of map als een transacted bewerking.

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

Parameterwaarden

lpFileName
De naam van een object dat moet worden gemaakt of geopend.

dwDesiredAccess
De toegang tot het object, dat kan worden samengevat als lezen, schrijven, beide of geen van beide (nul). De meest gebruikte waarden zijnGENERIC_READ, GENERIC_WRITEof beide: GENERIC_READ | GENERIC_WRITE

dwShareMode
De deelmodus van een object, dat kan worden gelezen, geschreven, beide, verwijderen, allemaal of geen: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

lpSecurityAttributes
Een aanwijzer naar een SECURITY_ATTRIBUTES structuur die een optionele beveiligingsdescriptor bevat en bepaalt ook of de geretourneerde ingang wel of niet kan worden overgenomen door onderliggende processen. De parameter kan NULL zijn.

dwCreationDisposition
Een actie die moet worden uitgevoerd op bestanden die bestaan en die niet bestaan. Deze parameter moet een van de volgende waarden zijn, die niet kunnen worden gecombineerd: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING of TRUNCATE_EXISTING.

dwFlagsAndAttributes
De bestandskenmerken en -vlaggen. Deze parameter kan elke combinatie van de beschikbare bestandskenmerken (FILE_ATTRIBUTE_*) bevatten. Alle andere bestandskenmerken overschrijven FILE_ATTRIBUTE_NORMAL. Deze parameter kan ook combinaties van vlaggen (FILE_FLAG_*) bevatten voor het beheer van buffergedrag, toegangsmodi en andere speciale vlaggen. Deze worden gecombineerd met eventuele FILE_ATTRIBUTE_*-waarden.

hTemplateFile
Een geldige ingang voor een sjabloonbestand met het GENERIC_READ toegangsrecht. Het sjabloonbestand levert bestandskenmerken en uitgebreide kenmerken voor het bestand dat wordt gemaakt. Deze parameter kan NULL zijn.

Retourwaarde

Retourneert een ingang die kan worden gebruikt voor toegang tot het object.

Opmerkingen

Met deze wrapper wordt de CreateFileTransacted functie aangeroepen.

DeleteFile

Hiermee verwijdert u een bestaand bestand als een transacted bewerking.

inline BOOL DeleteFile(LPCTSTR lpFileName);

Parameterwaarden

lpFileName
De naam van het bestand dat moet worden verwijderd.

Opmerkingen

Met deze wrapper wordt de DeleteFileTransacted functie aangeroepen.

FindFirstFile

Zoekt in een map naar een bestand of submap als een transacted bewerking.

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

Parameterwaarden

lpFileName
De map of het pad en de bestandsnaam die u zoekt. Deze parameter kan jokertekens bevatten, zoals een sterretje (*) of een vraagteken ().

pNextInfo
Een aanwijzer naar de WIN32_FIND_DATA structuur die informatie ontvangt over een gevonden bestand of submap.

Retourwaarde

Als de functie slaagt, is de retourwaarde een zoekgreep die wordt gebruikt in een volgende aanroep naar FindNextFile of FindClose. Als de functie mislukt of bestanden uit de zoekreeks in de parameter lpFileName niet kan vinden, wordt de retourwaarde INVALID_HANDLE_VALUE.

Opmerkingen

Met deze wrapper wordt de FindFirstFileTransacted functie aangeroepen.

GetFileAttributes

Haalt kenmerken van het bestandssysteem voor een opgegeven bestand of map op als een transacted bewerking.

inline DWORD GetFileAttributes(LPCTSTR lpFileName);

Parameterwaarden

lpFileName
De naam van het bestand of de map.

Opmerkingen

Met deze wrapper wordt de GetFileAttributesTransacted functie aangeroepen.

GetFileAttributesEx

Haalt kenmerken van het bestandssysteem voor een opgegeven bestand of map op als een transacted bewerking.

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

Parameterwaarden

lpFileName
De naam van het bestand of de map.

fInfoLevelId
Het kenmerkniveau dat moet worden opgehaald.

lpFileInformation
Een aanwijzer naar een buffer die de kenmerkgegevens ontvangt. Het type kenmerkgegevens dat in deze buffer is opgeslagen, wordt bepaald door de waarde van fInfoLevelId. Als de parameter fInfoLevelId GetFileExInfoStandard is, verwijst deze parameter naar een WIN32_FILE_ATTRIBUTE_DATA structuur.

Opmerkingen

Met deze wrapper wordt de GetFileAttributesTransacted functie aangeroepen.

GetHandle

Retourneert de transactie-handle.

HANDLE GetHandle() const;

Retourwaarde

Retourneert de transactie-handle voor een klasse. Retourneert NULL als de CAtlTransactionManager waarde niet is gekoppeld aan een ingang.

Opmerkingen

IsFallback

Bepaalt of de terugvalaanroepen zijn ingeschakeld.

BOOL IsFallback() const;

Retourwaarde

Retourneert TRUE is de klasse ondersteunt terugvalaanroepen. ANDERS ONWAAR.

Opmerkingen

m_bFallback

WAAR als de terugval wordt ondersteund; ANDERS ONWAAR.

BOOL m_bFallback;

Opmerkingen

m_hTransaction

De transactiehandler.

HANDLE m_hTransaction;

Opmerkingen

MoveFile

Hiermee verplaatst u een bestaand bestand of een map, inclusief de onderliggende items, als een transacted bewerking.

inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);

Parameterwaarden

lpOldFileName
De huidige naam van het bestaande bestand of de bestaande map op de lokale computer.

lpNewFileName
De nieuwe naam voor het bestand of de map. Deze naam mag nog niet bestaan. Een nieuw bestand bevindt zich mogelijk op een ander bestandssysteem of station. Een nieuwe map moet zich op hetzelfde station bevinden.

Opmerkingen

Met deze wrapper wordt de MoveFileTransacted functie aangeroepen.

RegCreateKeyEx

Hiermee maakt u de opgegeven registersleutel en koppelt u deze aan een transactie. Als de sleutel al bestaat, wordt deze door de functie geopend.

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

Parameterwaarden

hKey
Een ingang naar een geopende registersleutel.

lpSubKey
De naam van een subsleutel die met deze functie wordt geopend of gemaakt.

dwReserved
Deze parameter is gereserveerd en moet nul zijn.

lpClass
De door de gebruiker gedefinieerde klasse van deze sleutel. Deze parameter kan worden genegeerd. Deze parameter kan NULL zijn.

dwOptions
Deze parameter kan een van de volgende waarden zijn: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE of REG_OPTION_VOLATILE.

samDesired
Een masker dat de toegangsrechten voor de sleutel aangeeft.

lpSecurityAttributes
Aanwijzer naar een SECURITY_ATTRIBUTES structuur die bepaalt of de geretourneerde ingang kan worden overgenomen door onderliggende processen. Als lpSecurityAttributes NULL is, kan de ingang niet worden overgenomen.

phkResult
Een aanwijzer naar een variabele die een ingang ontvangt voor de geopende of gemaakte sleutel. Als de sleutel niet een van de vooraf gedefinieerde registersleutels is, roept u de RegCloseKey functie aan nadat u klaar bent met de ingang.

lpdwDisposition
Een aanwijzer naar een variabele die een van de volgende verwijderingswaarden ontvangt: REG_CREATED_NEW_KEY of REG_OPENED_EXISTING_KEY.

Retourwaarde

Als de functie slaagt, wordt de retourwaarde ERROR_SUCCESS. Als de functie mislukt, is de retourwaarde een niet-nulfoutcode die is gedefinieerd in Winerror.h.

Opmerkingen

Met deze wrapper wordt de RegCreateKeyTransacted functie aangeroepen.

RegDeleteKey

Hiermee verwijdert u een subsleutel en de bijbehorende waarden uit de opgegeven platformspecifieke weergave van het register als een transacted bewerking.

inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);

Parameterwaarden

hKey
Een ingang naar een geopende registersleutel.

lpSubKey
De naam van de sleutel die moet worden verwijderd.

Retourwaarde

Als de functie slaagt, wordt de retourwaarde ERROR_SUCCESS. Als de functie mislukt, is de retourwaarde een niet-nulfoutcode die is gedefinieerd in Winerror.h.

Opmerkingen

Met deze wrapper wordt de RegDeleteKeyTransacted functie aangeroepen.

RegOpenKeyEx

Hiermee opent u de opgegeven registersleutel en koppelt u deze aan een transactie.

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

Parameterwaarden

hKey
Een ingang naar een geopende registersleutel.

lpSubKey
De naam van de registersubsleutel die moet worden geopend.

ulOptions
Deze parameter is gereserveerd en moet nul zijn.

samDesired
Een masker dat de toegangsrechten voor de sleutel aangeeft.

phkResult
Een aanwijzer naar een variabele die een ingang ontvangt voor de geopende of gemaakte sleutel. Als de sleutel niet een van de vooraf gedefinieerde registersleutels is, roept u de RegCloseKey functie aan nadat u klaar bent met de ingang.

Retourwaarde

Als de functie slaagt, wordt de retourwaarde ERROR_SUCCESS. Als de functie mislukt, is de retourwaarde een niet-nulfoutcode die is gedefinieerd in Winerror.h

Opmerkingen

Met deze wrapper wordt de RegOpenKeyTransacted functie aangeroepen.

Terugdraaien

Aanvragen dat de transactie wordt teruggedraaid.

inline BOOL Rollback();

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

Met deze wrapper wordt de RollbackTransaction functie aangeroepen.

SetFileAttributes

Hiermee stelt u de kenmerken voor een bestand of map in als een transacted bewerking.

inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);

Parameterwaarden

lpFileName
De naam van het bestand of de map.

dwAttributes
De bestandskenmerken die moeten worden ingesteld voor het bestand. Zie SetFileAttributesTransacted voor meer informatie.

Opmerkingen

Met deze wrapper wordt de SetFileAttributesTransacted functie aangeroepen.

Zie ook

ATL COM Desktop Components