Klasa CAtlTransactionManager

Klasa CAtlTransactionManager udostępnia funkcje menedżera transakcji jądra (KTM).

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

class CAtlTransactionManager;

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
~CAtlTransactionManager	Destruktor CAtlTransactionManager.
CAtlTransactionManager	CAtlTransactionManager, konstruktor.

Metody publiczne

Nazwa/nazwisko	opis
Zamknij	Zamyka jeden dojście transakcji.
Popełnić	Żąda zatwierdzenia transakcji.
Utwórz	Tworzy dojście transakcji.
CreateFile	Tworzy lub otwiera plik, strumień plików lub katalog jako operację transakcji.
Usuń plik	Usuwa istniejący plik jako operację transakcji.
FindFirstFile	Wyszukuje w katalogu plik lub podkatalog jako operację transakcji.
GetFileAttributes	Pobiera atrybuty systemu plików dla określonego pliku lub katalogu jako transakcji operacji.
GetFileAttributesEx	Pobiera atrybuty systemu plików dla określonego pliku lub katalogu jako transakcji operacji.
GetHandle	Zwraca uchwyt transakcji.
IsFallback	Określa, czy wywołania rezerwowe są włączone.
MoveFile	Przenosi istniejący plik lub katalog, w tym jego elementy podrzędne, jako operację transakcji.
RegCreateKeyEx	Tworzy określony klucz rejestru i kojarzy go z transakcją. Jeśli klucz już istnieje, funkcja zostanie otwarta.
RegDeleteKey	Usuwa podklucz i jego wartości z określonego widoku rejestru specyficznego dla platformy jako transakcji operacji.
RegOpenKeyEx	Otwiera określony klucz rejestru i kojarzy go z transakcją.
Wycofywanie	Żąda, aby transakcja została wycofana.
SetFileAttributes	Ustawia atrybuty pliku lub katalogu jako operację transaktoryzowaną.

Chronione składowe danych

Nazwa/nazwisko	opis
m_bFallback	Wartość TRUE, jeśli rezerwowa jest obsługiwana; FAŁSZ w przeciwnym razie.
m_hTransaction	Dojście transakcji.

Uwagi

Hierarchia dziedziczenia

ATL::CAtlTransactionManager

Wymagania

Nagłówek: atltransactionmanager.h

~CAtlTransactionManager

Destruktor CAtlTransactionManager.

virtual ~CAtlTransactionManager();

Uwagi

W normalnym przetwarzaniu transakcja jest automatycznie zatwierdzana i zamykana. Jeśli destruktor jest wywoływany podczas odwijania wyjątku, transakcja zostanie wycofana i zamknięta.

CAtlTransactionManager

CAtlTransactionManager, konstruktor.

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

Parametry

bFallback
Wartość TRUE wskazuje rezerwową obsługę. Jeśli funkcja transacted zakończy się niepowodzeniem, klasa automatycznie wywołuje funkcję "non-transacted". Wartość FALSE nie wskazuje żadnych wywołań rezerwowych.

bAutoCreateTransaction
Wartość TRUE wskazuje, że procedura obsługi transakcji jest tworzona automatycznie w konstruktorze. FAŁSZ wskazuje, że nie jest.

Uwagi

Zamknij

Zamyka dojście transakcji.

inline BOOL Close();

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Ta otoka wywołuje CloseHandle funkcję . Metoda jest automatycznie wywoływana w destruktorze.

Zatwierdzenie

Żąda zatwierdzenia transakcji.

inline BOOL Commit();

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Ta otoka wywołuje CommitTransaction funkcję . Metoda jest automatycznie wywoływana w destruktorze.

Utworzenie

Tworzy dojście transakcji.

inline BOOL Create();

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Ta otoka wywołuje CreateTransaction funkcję . Sprawdź, czy

CreateFile

Tworzy lub otwiera plik, strumień plików lub katalog jako operację transakcji.

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

Parametry

lpFileName
Nazwa obiektu, który ma zostać utworzony lub otwarty.

dwDesiredAccess
Dostęp do obiektu, który można podsumować jako odczyt, zapis, oba lub nie (zero). Najczęściej używane wartości to GENERIC_READ, GENERIC_WRITElub oba: GENERIC_READ | GENERIC_WRITE.

dwShareMode
Tryb udostępniania obiektu, który może być odczytywany, zapisywany, oba, usuwany, wszystkie z nich lub brak: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

lpSecurityAttributes
Wskaźnik do struktury SECURITY_ATTRIBUTES, która zawiera opcjonalny deskryptor zabezpieczeń, a także określa, czy zwracany uchwyt może być dziedziczony przez procesy podrzędne. Parametr może mieć wartość NULL.

dwCreationDisposition
Akcja do wykonania dla plików, które istnieją i nie istnieją. Ten parametr musi być jedną z następujących wartości, których nie można połączyć: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING lub TRUNCATE_EXISTING.

dwFlagsAndAttributes
Atrybuty i flagi pliku. Ten parametr może zawierać dowolną kombinację dostępnych atrybutów pliku (FILE_ATTRIBUTE_*). Wszystkie inne atrybuty pliku zastępują FILE_ATTRIBUTE_NORMAL. Ten parametr może również zawierać kombinacje flag (FILE_FLAG_*) w celu kontrolowania zachowania buforowania, trybów dostępu i innych flag specjalnego przeznaczenia. Te wartości łączą się z dowolnymi wartościami FILE_ATTRIBUTE_*.

hTemplateFile
Prawidłowa obsługa pliku szablonu z prawem dostępu GENERIC_READ. Plik szablonu dostarcza atrybuty pliku i atrybuty rozszerzone dla tworzonego pliku. Ten parametr może mieć wartość NULL.

Wartość zwracana

Zwraca uchwyt, który może służyć do uzyskiwania dostępu do obiektu.

Uwagi

Ta otoka wywołuje CreateFileTransacted funkcję .

Usuń plik

Usuwa istniejący plik jako operację transakcji.

inline BOOL DeleteFile(LPCTSTR lpFileName);

Parametry

lpFileName
Nazwa pliku do usunięcia.

Uwagi

Ta otoka wywołuje DeleteFileTransacted funkcję .

FindFirstFile

Wyszukuje w katalogu plik lub podkatalog jako operację transakcji.

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

Parametry

lpFileName
Katalog lub ścieżka oraz nazwa pliku do wyszukania. Ten parametr może zawierać symbole wieloznaczne, takie jak gwiazdka (*) lub znak zapytania ().

pNextInfo
Wskaźnik do struktury WIN32_FIND_DATA, która odbiera informacje o znalezionym pliku lub podkatalogu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest uchwytem wyszukiwania używanym w kolejnym wywołaniu metody FindNextFile lub FindClose. Jeśli funkcja nie powiedzie się lub nie można zlokalizować plików z ciągu wyszukiwania w parametrze lpFileName , zwracana wartość jest INVALID_HANDLE_VALUE.

Uwagi

Ta otoka wywołuje FindFirstFileTransacted funkcję .

GetFileAttributes

Pobiera atrybuty systemu plików dla określonego pliku lub katalogu jako transakcji operacji.

inline DWORD GetFileAttributes(LPCTSTR lpFileName);

Parametry

lpFileName
Nazwa pliku lub katalogu.

Uwagi

Ta otoka wywołuje GetFileAttributesTransacted funkcję .

GetFileAttributesEx

Pobiera atrybuty systemu plików dla określonego pliku lub katalogu jako transakcji operacji.

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

Parametry

lpFileName
Nazwa pliku lub katalogu.

fInfoLevelId
Poziom informacji o atrybutach do pobrania.

lpFileInformation
Wskaźnik do buforu, który odbiera informacje o atrybucie. Typ informacji o atrybutach przechowywanych w tym buforze jest określany przez wartość fInfoLevelId. Jeśli parametr fInfoLevelId to GetFileExInfoStandard, ten parametr wskazuje WIN32_FILE_ATTRIBUTE_DATA strukturę.

Uwagi

Ta otoka wywołuje GetFileAttributesTransacted funkcję .

GetHandle

Zwraca uchwyt transakcji.

HANDLE GetHandle() const;

Wartość zwracana

Zwraca uchwyt transakcji dla klasy. Zwraca wartość NULL, jeśli CAtlTransactionManager uchwyt nie jest dołączony.

Uwagi

IsFallback

Określa, czy wywołania rezerwowe są włączone.

BOOL IsFallback() const;

Wartość zwracana

Zwraca wartość TRUE to klasa obsługuje wywołania rezerwowe. FAŁSZ w przeciwnym razie.

Uwagi

m_bFallback

Wartość TRUE, jeśli rezerwowa jest obsługiwana; FAŁSZ w przeciwnym razie.

BOOL m_bFallback;

Uwagi

m_hTransaction

Dojście transakcji.

HANDLE m_hTransaction;

Uwagi

MoveFile

Przenosi istniejący plik lub katalog, w tym jego elementy podrzędne, jako operację transakcji.

inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);

Parametry

lpOldFileName
Bieżąca nazwa istniejącego pliku lub katalogu na komputerze lokalnym.

lpNewFileName
Nowa nazwa pliku lub katalogu. Ta nazwa nie może jeszcze istnieć. Nowy plik może znajdować się w innym systemie plików lub na innym dysku. Nowy katalog musi znajdować się na tym samym dysku.

Uwagi

Ta otoka wywołuje MoveFileTransacted funkcję .

RegCreateKeyEx

Tworzy określony klucz rejestru i kojarzy go z transakcją. Jeśli klucz już istnieje, funkcja zostanie otwarta.

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
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa podklucza, który zostanie otwarty lub utworzony przez tę funkcję.

dwReserved
Ten parametr jest zarezerwowany i musi mieć wartość zero.

lpClass
Zdefiniowana przez użytkownika klasa tego klucza. Ten parametr może być ignorowany. Ten parametr może mieć wartość NULL.

dwOptions
Ten parametr może być jedną z następujących wartości: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE lub REG_OPTION_VOLATILE.

samDesired
Maska określająca prawa dostępu dla klucza.

lpSecurityAttributes
Wskaźnik do struktury SECURITY_ATTRIBUTES, która określa, czy zwrócony uchwyt może być dziedziczony przez procesy podrzędne. Jeśli atrybuty lpSecurityAttributes mają wartość NULL, nie można dziedziczyć uchwytu.

phkResult
Wskaźnik do zmiennej, która odbiera uchwyt do otwartego lub utworzonego klucza. Jeśli klucz nie jest jednym ze wstępnie zdefiniowanych kluczy rejestru, wywołaj RegCloseKey funkcję po zakończeniu korzystania z uchwytu.

lpdwDisposition
Wskaźnik do zmiennej, która otrzymuje jedną z następujących wartości dyspozycji: REG_CREATED_NEW_KEY lub REG_OPENED_EXISTING_KEY.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Uwagi

Ta otoka wywołuje RegCreateKeyTransacted funkcję .

RegDeleteKey

Usuwa podklucz i jego wartości z określonego widoku rejestru specyficznego dla platformy jako transakcji operacji.

inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa klucza do usunięcia.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Uwagi

Ta otoka wywołuje RegDeleteKeyTransacted funkcję .

RegOpenKeyEx

Otwiera określony klucz rejestru i kojarzy go z transakcją.

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

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa podklucza rejestru, który ma zostać otwarty.

ulOptions
Ten parametr jest zarezerwowany i musi mieć wartość zero.

samDesired
Maska określająca prawa dostępu dla klucza.

phkResult
Wskaźnik do zmiennej, która odbiera uchwyt do otwartego lub utworzonego klucza. Jeśli klucz nie jest jednym ze wstępnie zdefiniowanych kluczy rejestru, wywołaj RegCloseKey funkcję po zakończeniu korzystania z uchwytu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h

Uwagi

Ta otoka wywołuje RegOpenKeyTransacted funkcję .

Wycofywanie

Żąda, aby transakcja została wycofana.

inline BOOL Rollback();

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Ta otoka wywołuje RollbackTransaction funkcję .

SetFileAttributes

Ustawia atrybuty pliku lub katalogu jako operację transaktoryzowaną.

inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);

Parametry

lpFileName
Nazwa pliku lub katalogu.

dwAttributes
Atrybuty pliku do ustawienia dla pliku. Aby uzyskać więcej informacji, zobacz SetFileAttributesTransacted.

Uwagi

Ta otoka wywołuje SetFileAttributesTransacted funkcję .

Zobacz też

Składniki ATL COM pulpitu