Aracılığıyla paylaş

CAtlTransactionManager Sınıfı

  • Makale

CAtlTransactionManager sınıfı, Çekirdek İşlem Yöneticisi (KTM) işlevlerine bir sarmalayıcı sağlar.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

class CAtlTransactionManager;

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
~CAtlTransactionManager CAtlTransactionManager yıkıcısı.
CAtlTransactionManager CAtlTransactionManager oluşturucu.

Genel Yöntemler

Veri Akışı Adı Açıklama
Kapat İşlem tutamacını kapatır.
İşlemek İşlemin işlenmesini istemektedir.
Oluştur İşlem tutamacını oluşturur.
CreateFile İşlem yapılan bir işlem olarak bir dosya, dosya akışı veya dizin oluşturur veya açar.
DeleteFile İşlem yapılan bir işlem olarak var olan bir dosyayı siler.
FindFirstFile İşlem yapılan bir işlem olarak bir dizinde dosya veya alt dizin arar.
GetFileAttributes İşlem yapılan bir işlem olarak belirtilen bir dosya veya dizin için dosya sistemi özniteliklerini alır.
GetFileAttributesEx İşlem yapılan bir işlem olarak belirtilen bir dosya veya dizin için dosya sistemi özniteliklerini alır.
GetHandle İşlem tutamacını döndürür.
IsFallback Geri dönüş çağrılarının etkinleştirilip etkinleştirilmediğini belirler.
MoveFile İşlem yapılan bir işlem olarak, alt öğeleri de dahil olmak üzere mevcut bir dosyayı veya dizini taşır.
RegCreateKeyEx Belirtilen kayıt defteri anahtarını oluşturur ve bir işlemle ilişkilendirir. Anahtar zaten varsa işlev anahtarı açar.
RegDeleteKey Bir alt anahtarı ve değerlerini, işlem yapılan işlem olarak kayıt defterinin belirtilen platforma özgü görünümünden siler.
RegOpenKeyEx Belirtilen kayıt defteri anahtarını açar ve bir işlemle ilişkilendirir.
Geri alma İşlemin geri alınması isteğinde bulunur.
SetFileAttributes Bir dosya veya dizinin özniteliklerini işlem yapılmış bir işlem olarak ayarlar.

Korumalı Veri Üyeleri

Veri Akışı Adı Açıklama
m_bFallback Geri dönüş destekleniyorsa TRUE; FALSE aksi takdirde.
m_hTransaction İşlem tutamacı.

Açıklamalar

Devralma Hiyerarşisi

ATL::CAtlTransactionManager

Gereksinimler

Üst bilgi: atltransactionmanager.h

~CAtlTransactionManager

CAtlTransactionManager yıkıcısı.

virtual ~CAtlTransactionManager();

Açıklamalar

Normal işlemede işlem otomatik olarak işlenir ve kapatılır. Bir özel durum geri sarma sırasında yıkıcı çağrılırsa, işlem geri alınır ve kapatılır.

CAtlTransactionManager

CAtlTransactionManager oluşturucu.

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

Parametreler

bFallback
TRUE, destek geri dönüşünü gösterir. İşlem yapılan işlev başarısız olursa sınıf otomatik olarak "işlemsiz" işlevini çağırır. YANLIŞ hiçbir "geri dönüş" çağrısı olmadığını gösterir.

bAutoCreateTransaction
TRUE, işlem işleyicisinin oluşturucuda otomatik olarak oluşturulduğunu gösterir. YANLIŞ, bunun olmadığını gösterir.

Açıklamalar

Kapat

İşlem tutamacını kapatır.

inline BOOL Close();

Dönüş Değeri

Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu sarmalayıcı işlevi çağırır CloseHandle . yöntemi, yıkıcıda otomatik olarak çağrılır.

İşleme

İşlemin işlenmesini istemektedir.

inline BOOL Commit();

Dönüş Değeri

Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu sarmalayıcı işlevi çağırır CommitTransaction . yöntemi, yıkıcıda otomatik olarak çağrılır.

Oluşturma

İşlem tutamacını oluşturur.

inline BOOL Create();

Dönüş Değeri

Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu sarmalayıcı işlevi çağırır CreateTransaction . Kontrol edin

CreateFile

İşlem yapılan bir işlem olarak bir dosya, dosya akışı veya dizin oluşturur veya açar.

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

Parametreler

lpFileName
Oluşturulacak veya açılacak nesnenin adı.

dwDesiredAccess
Okuma, yazma, her ikisi veya hiçbiri (sıfır) olarak özetlenebilir nesneye erişim. En sık kullanılan değerler , GENERIC_WRITEveya her ikisidirGENERIC_READ: GENERIC_READ | GENERIC_WRITE.

dwShareMode
Bir nesnenin okuma, yazma, her ikisi, silme, bunların tümü veya hiçbiri gibi paylaşım modu: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

lpSecurityAttributes
İsteğe bağlı bir güvenlik tanımlayıcısı içeren ve ayrıca döndürülen tanıtıcının alt işlemler tarafından devralınıp devralınamayacağını belirleyen SECURITY_ATTRIBUTES yapısına yönelik bir işaretçi. Parametresi NULL olabilir.

dwCreationDisposition
Var olan ve var olmayan dosyalar üzerinde yapılacak bir eylem. Bu parametre birleştirilemeyen şu değerlerden biri olmalıdır: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING veya TRUNCATE_EXISTING.

dwFlagsAndAttributes
Dosya öznitelikleri ve bayrakları. Bu parametre, kullanılabilir dosya özniteliklerinin (FILE_ATTRIBUTE_*) herhangi bir bileşimini içerebilir. Diğer tüm dosya öznitelikleri FILE_ATTRIBUTE_NORMAL geçersiz kılar. Bu parametre ayrıca arabelleğe alma davranışını, erişim modlarını ve diğer özel amaçlı bayrakları denetlemek için bayrak birleşimleri (FILE_FLAG_*) içerebilir. Bunlar tüm FILE_ATTRIBUTE_* değerlerle birleştirilir.

hTemplateFile
GENERIC_READ erişim hakkı olan bir şablon dosyasının geçerli tanıtıcısı. Şablon dosyası, oluşturulan dosya için dosya öznitelikleri ve genişletilmiş öznitelikler sağlar. Bu parametre NULL olabilir.

Dönüş Değeri

Nesneye erişmek için kullanılabilecek bir tanıtıcı döndürür.

Açıklamalar

Bu sarmalayıcı işlevi çağırır CreateFileTransacted .

DeleteFile

İşlem yapılan bir işlem olarak var olan bir dosyayı siler.

inline BOOL DeleteFile(LPCTSTR lpFileName);

Parametreler

lpFileName
Silinecek dosyanın adı.

Açıklamalar

Bu sarmalayıcı işlevi çağırır DeleteFileTransacted .

FindFirstFile

İşlem yapılan bir işlem olarak bir dizinde dosya veya alt dizin arar.

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

Parametreler

lpFileName
Dizin veya yol ve aranacak dosya adı. Bu parametre yıldız (*) veya soru işareti () gibi joker karakterler içerebilir.

pNextInfo
Bulunan bir dosya veya alt dizin hakkında bilgi alan WIN32_FIND_DATA yapısının işaretçisi.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri sonraki FindCloseveya çağrısında FindNextFile kullanılan bir arama tanıtıcısıdır. İşlev lpFileName parametresindeki arama dizesinden dosyaları bulamazsa veya bulamazsa, dönüş değeri INVALID_HANDLE_VALUE.

Açıklamalar

Bu sarmalayıcı işlevi çağırır FindFirstFileTransacted .

GetFileAttributes

İşlem yapılan bir işlem olarak belirtilen bir dosya veya dizin için dosya sistemi özniteliklerini alır.

inline DWORD GetFileAttributes(LPCTSTR lpFileName);

Parametreler

lpFileName
Dosyanın veya dizinin adı.

Açıklamalar

Bu sarmalayıcı işlevi çağırır GetFileAttributesTransacted .

GetFileAttributesEx

İşlem yapılan bir işlem olarak belirtilen bir dosya veya dizin için dosya sistemi özniteliklerini alır.

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

Parametreler

lpFileName
Dosyanın veya dizinin adı.

fInfoLevelId
Alınacak öznitelik bilgilerinin düzeyi.

lpFileInformation
Öznitelik bilgilerini alan bir arabelleğe yönelik işaretçi. Bu arabelleğe depolanan öznitelik bilgilerinin türü fInfoLevelId değeriyle belirlenir. fInfoLevelId parametresi GetFileExInfoStandard ise bu parametre WIN32_FILE_ATTRIBUTE_DATA bir yapıya işaret etti demektir.

Açıklamalar

Bu sarmalayıcı işlevi çağırır GetFileAttributesTransacted .

GetHandle

İşlem tutamacını döndürür.

HANDLE GetHandle() const;

Dönüş Değeri

Sınıfın işlem tutamacını döndürür. bir tanıtıcıya CAtlTransactionManager bağlı değilse NULL döndürür.

Açıklamalar

IsFallback

Geri dönüş çağrılarının etkinleştirilip etkinleştirilmediğini belirler.

BOOL IsFallback() const;

Dönüş Değeri

Sınıfın geri dönüş çağrılarını desteklediği true döndürür. FALSE aksi takdirde.

Açıklamalar

m_bFallback

Geri dönüş destekleniyorsa TRUE; FALSE aksi takdirde.

BOOL m_bFallback;

Açıklamalar

m_hTransaction

İşlem tutamacı.

HANDLE m_hTransaction;

Açıklamalar

MoveFile

İşlem yapılan bir işlem olarak, alt öğeleri de dahil olmak üzere mevcut bir dosyayı veya dizini taşır.

inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);

Parametreler

lpOldFileName
Yerel bilgisayardaki mevcut dosyanın veya dizinin geçerli adı.

lpNewFileName
Dosya veya dizin için yeni ad. Bu ad zaten mevcut olmamalıdır. Yeni bir dosya farklı bir dosya sisteminde veya sürücüde olabilir. Yeni bir dizin aynı sürücüde olmalıdır.

Açıklamalar

Bu sarmalayıcı işlevi çağırır MoveFileTransacted .

RegCreateKeyEx

Belirtilen kayıt defteri anahtarını oluşturur ve bir işlemle ilişkilendirir. Anahtar zaten varsa işlev anahtarı açar.

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

Parametreler

hKey
Açık kayıt defteri anahtarının tanıtıcısı.

lpSubKey
Bu işlevin açtığı veya oluşturduğu alt anahtarın adı.

dwReserved
Bu parametre ayrılmıştır ve sıfır olmalıdır.

lpClass
Bu anahtarın kullanıcı tanımlı sınıfı. Bu parametre yoksayılabilir. Bu parametre NULL olabilir.

dwOptions
Bu parametre şu değerlerden biri olabilir: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE veya REG_OPTION_VOLATILE.

samDesired
Anahtarın erişim haklarını belirten bir maske.

lpSecurityAttributes
Döndürülen tanıtıcının alt işlemler tarafından devralınıp devralınamayacağını belirleyen bir SECURITY_ATTRIBUTES yapısının işaretçisi. lpSecurityAttributes NULL ise, tanıtıcı devralınamaz.

phkResult
Açılan veya oluşturulan anahtara tanıtıcı alan bir değişken işaretçisi. Anahtar önceden tanımlanmış kayıt defteri anahtarlarından biri değilse, tanıtıcıyı RegCloseKey kullanmayı bitirdikten sonra işlevini çağırın.

lpdwDisposition
Aşağıdaki değerlendirme değerlerinden birini alan bir değişkenin işaretçisi: REG_CREATED_NEW_KEY veya REG_OPENED_EXISTING_KEY.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.

Açıklamalar

Bu sarmalayıcı işlevi çağırır RegCreateKeyTransacted .

RegDeleteKey

Bir alt anahtarı ve değerlerini, işlem yapılan işlem olarak kayıt defterinin belirtilen platforma özgü görünümünden siler.

inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);

Parametreler

hKey
Açık kayıt defteri anahtarının tanıtıcısı.

lpSubKey
Silinecek anahtarın adı.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.

Açıklamalar

Bu sarmalayıcı işlevi çağırır RegDeleteKeyTransacted .

RegOpenKeyEx

Belirtilen kayıt defteri anahtarını açar ve bir işlemle ilişkilendirir.

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

Parametreler

hKey
Açık kayıt defteri anahtarının tanıtıcısı.

lpSubKey
Açılacak kayıt defteri alt anahtarının adı.

ulOptions
Bu parametre ayrılmıştır ve sıfır olmalıdır.

samDesired
Anahtarın erişim haklarını belirten bir maske.

phkResult
Açılan veya oluşturulan anahtara tanıtıcı alan bir değişken işaretçisi. Anahtar önceden tanımlanmış kayıt defteri anahtarlarından biri değilse, tanıtıcıyı RegCloseKey kullanmayı bitirdikten sonra işlevini çağırın.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur

Açıklamalar

Bu sarmalayıcı işlevi çağırır RegOpenKeyTransacted .

Geri alma

İşlemin geri alınması isteğinde bulunur.

inline BOOL Rollback();

Dönüş Değeri

Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu sarmalayıcı işlevi çağırır RollbackTransaction .

SetFileAttributes

Bir dosya veya dizinin özniteliklerini işlem yapılmış bir işlem olarak ayarlar.

inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);

Parametreler

lpFileName
Dosyanın veya dizinin adı.

dwAttributes
Dosya için ayarlanacağı dosya öznitelikleri. Daha fazla bilgi için bkz . SetFileAttributesTransacted.

Açıklamalar

Bu sarmalayıcı işlevi çağırır SetFileAttributesTransacted .

Ayrıca bkz.

ATL COM Masaüstü Bileşenleri