Bagikan melalui

Kelas CAtlTransactionManager

Kelas CAtlTransactionManager menyediakan pembungkus ke fungsi Kernel Transaction Manager (KTM).

Penting

Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Sintaks

class CAtlTransactionManager;

Anggota

Konstruktor Publik

Nama Deskripsi
~CAtlTransactionManager Destruktor CAtlTransactionManager.
CAtlTransactionManager Konstruktor CAtlTransactionManager.

Metode Publik

Nama Deskripsi
Tutup Menutup satu handel transaksi.
Melakukan Meminta agar transaksi dilakukan.
Buat Membuat handel transaksi.
CreateFile Membuat atau membuka file, aliran file, atau direktori sebagai operasi yang ditransaksikan.
DeleteFile Menghapus file yang ada sebagai operasi yang ditransaksikan.
FindFirstFile Mencari direktori untuk file atau subdirektori sebagai operasi yang ditransaksikan.
GetFileAttributes Mengambil atribut sistem file untuk file atau direktori tertentu sebagai operasi yang ditransaksikan.
GetFileAttributesEx Mengambil atribut sistem file untuk file atau direktori tertentu sebagai operasi yang ditransaksikan.
GetHandle Mengembalikan handel transaksi.
IsFallback Menentukan apakah panggilan fallback diaktifkan.
MoveFile Memindahkan file atau direktori yang ada, termasuk turunannya, sebagai operasi yang ditransaksikan.
RegCreateKeyEx Membuat kunci registri yang ditentukan dan mengaitkannya dengan transaksi. Jika kunci sudah ada, fungsi akan membukanya.
RegDeleteKey Menghapus subkuntang dan nilainya dari tampilan khusus platform yang ditentukan dari registri sebagai operasi yang ditransaksikan.
RegOpenKeyEx Membuka kunci registri yang ditentukan dan mengaitkannya dengan transaksi.
Rollback Meminta agar transaksi digulung balik.
SetFileAttributes Mengatur atribut untuk file atau direktori sebagai operasi yang ditransaksikan.

Anggota Data yang Dilindungi

Nama Deskripsi
m_bFallback TRUE jika fallback didukung; FALSE jika tidak.
m_hTransaction Handel transaksi.

Keterangan

Hierarki Warisan

ATL::CAtlTransactionManager

Persyaratan

Header: atltransactionmanager.h

~CAtlTransactionManager

Destruktor CAtlTransactionManager.

virtual ~CAtlTransactionManager();

Keterangan

Dalam pemrosesan normal, transaksi secara otomatis dilakukan dan ditutup. Jika destruktor dipanggil selama pembatalan pengecualian, transaksi digulung balik dan ditutup.

CAtlTransactionManager

Konstruktor CAtlTransactionManager.

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

Parameter

bFallback
TRUE menunjukkan dukungan fallback. Jika fungsi yang ditransaksikan gagal, kelas secara otomatis memanggil fungsi "tidak ditransaksikan". FALSE tidak menunjukkan panggilan "fallback".

bAutoCreateTransaction
TRUE menunjukkan bahwa handler transaksi dibuat secara otomatis di konstruktor. FALSE menunjukkan bahwa itu tidak.

Keterangan

Tutup

Menutup handel transaksi.

inline BOOL Close();

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Pembungkus CloseHandle ini memanggil fungsi . Metode ini secara otomatis dipanggil dalam destruktor.

Menjalankan

Meminta agar transaksi dilakukan.

inline BOOL Commit();

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Pembungkus CommitTransaction ini memanggil fungsi . Metode ini secara otomatis dipanggil dalam destruktor.

Buat

Membuat handel transaksi.

inline BOOL Create();

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Pembungkus CreateTransaction ini memanggil fungsi . Periksa untuk

CreateFile

Membuat atau membuka file, aliran file, atau direktori sebagai operasi yang ditransaksikan.

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

Parameter

lpFileName
Nama objek yang akan dibuat atau dibuka.

dwDesiredAccess
Akses ke objek, yang dapat diringkas sebagai baca, tulis, keduanya, atau tidak sama sekali (nol). Nilai yang paling umum digunakan adalah GENERIC_READ, , GENERIC_WRITEatau keduanya: GENERIC_READ | GENERIC_WRITE.

dwShareMode
Mode berbagi objek, yang dapat dibaca, ditulis, keduanya, hapus, semua ini, atau tidak ada: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

lpSecurityAttributes
Penunjuk ke struktur SECURITY_ATTRIBUTES yang berisi deskriptor keamanan opsional dan juga menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses turunan atau tidak. Parameternya bisa NULL.

dwCreationDisposition
Tindakan yang harus diambil pada file yang ada dan tidak ada. Parameter ini harus merupakan salah satu nilai berikut, yang tidak dapat digabungkan: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING, atau TRUNCATE_EXISTING.

dwFlagsAndAttributes
Atribut dan bendera file. Parameter ini dapat mencakup kombinasi atribut file yang tersedia (FILE_ATTRIBUTE_*). Semua atribut file lainnya mengambil alih FILE_ATTRIBUTE_NORMAL. Parameter ini juga dapat berisi kombinasi bendera (FILE_FLAG_*) untuk kontrol perilaku buffering, mode akses, dan bendera tujuan khusus lainnya. Ini dikombinasikan dengan nilai FILE_ATTRIBUTE_*.

hTemplateFile
Handel yang valid ke file templat dengan akses GENERIC_READ kanan. File templat menyediakan atribut file dan atribut yang diperluas untuk file yang sedang dibuat. Parameter ini bisa NULL.

Tampilkan Nilai

Mengembalikan handel yang dapat digunakan untuk mengakses objek.

Keterangan

Pembungkus CreateFileTransacted ini memanggil fungsi .

DeleteFile

Menghapus file yang ada sebagai operasi yang ditransaksikan.

inline BOOL DeleteFile(LPCTSTR lpFileName);

Parameter

lpFileName
Nama file yang akan dihapus.

Keterangan

Pembungkus DeleteFileTransacted ini memanggil fungsi .

FindFirstFile

Mencari direktori untuk file atau subdirektori sebagai operasi yang ditransaksikan.

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

Parameter

lpFileName
Direktori atau jalur, dan nama file yang akan dicari. Parameter ini dapat mencakup karakter kartubebas, seperti tanda bintang (*) atau tanda tanya ().

pNextInfo
Penunjuk ke struktur WIN32_FIND_DATA yang menerima informasi tentang file atau subdirektori yang ditemukan.

Tampilkan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang digunakan dalam panggilan berikutnya ke FindNextFile atau FindClose. Jika fungsi gagal atau gagal menemukan file dari string pencarian di parameter lpFileName , nilai yang dikembalikan adalah INVALID_HANDLE_VALUE.

Keterangan

Pembungkus FindFirstFileTransacted ini memanggil fungsi .

GetFileAttributes

Mengambil atribut sistem file untuk file atau direktori tertentu sebagai operasi yang ditransaksikan.

inline DWORD GetFileAttributes(LPCTSTR lpFileName);

Parameter

lpFileName
Nama file atau direktori.

Keterangan

Pembungkus GetFileAttributesTransacted ini memanggil fungsi .

GetFileAttributesEx

Mengambil atribut sistem file untuk file atau direktori tertentu sebagai operasi yang ditransaksikan.

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

Parameter

lpFileName
Nama file atau direktori.

fInfoLevelId
Tingkat informasi atribut yang akan diambil.

lpFileInformation
Penunjuk ke buffer yang menerima informasi atribut. Jenis informasi atribut yang disimpan ke dalam buffer ini ditentukan oleh nilai fInfoLevelId. Jika parameter fInfoLevelId adalah GetFileExInfoStandard, parameter ini menunjuk ke struktur WIN32_FILE_ATTRIBUTE_DATA.

Keterangan

Pembungkus GetFileAttributesTransacted ini memanggil fungsi .

GetHandle

Mengembalikan handel transaksi.

HANDLE GetHandle() const;

Tampilkan Nilai

Mengembalikan handel transaksi untuk kelas. Mengembalikan NULL jika CAtlTransactionManager tidak dilampirkan ke handel.

Keterangan

IsFallback

Menentukan apakah panggilan fallback diaktifkan.

BOOL IsFallback() const;

Tampilkan Nilai

Mengembalikan TRUE adalah kelas yang mendukung panggilan fallback. FALSE jika tidak.

Keterangan

m_bFallback

TRUE jika fallback didukung; FALSE jika tidak.

BOOL m_bFallback;

Keterangan

m_hTransaction

Handel transaksi.

HANDLE m_hTransaction;

Keterangan

MoveFile

Memindahkan file atau direktori yang ada, termasuk turunannya, sebagai operasi yang ditransaksikan.

inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);

Parameter

lpOldFileName
Nama file atau direktori yang ada saat ini pada komputer lokal.

lpNewFileName
Nama baru untuk file atau direktori. Nama ini belum boleh ada. Berkas baru mungkin ada pada sistem file atau drive yang berbeda. Direktori baru harus berada di drive yang sama.

Keterangan

Pembungkus MoveFileTransacted ini memanggil fungsi .

RegCreateKeyEx

Membuat kunci registri yang ditentukan dan mengaitkannya dengan transaksi. Jika kunci sudah ada, fungsi akan membukanya.

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
Handel ke kunci registri terbuka.

lpSubKey
Nama subkunci yang dibuka atau dibuat fungsi ini.

dwReserved
Parameter ini dicadangkan dan harus nol.

lpClass
Kelas yang ditentukan pengguna dari kunci ini. Parameter ini dapat diabaikan. Parameter ini bisa NULL.

dwOptions
Parameter ini bisa menjadi salah satu nilai berikut: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, atau REG_OPTION_VOLATILE.

samDesired
Masker yang menentukan hak akses untuk kunci.

lpSecurityAttributes
Penunjuk ke struktur SECURITY_ATTRIBUTES yang menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses anak. Jika lpSecurityAttributes adalah NULL, handel tidak dapat diwariskan.

phkResult
Penunjuk ke variabel yang menerima handel ke kunci yang dibuka atau dibuat. Jika kunci bukan salah satu kunci registri yang telah ditentukan sebelumnya, panggil RegCloseKey fungsi setelah Anda selesai menggunakan handel.

lpdwDisposition
Penunjuk ke variabel yang menerima salah satu nilai disposisi berikut: REG_CREATED_NEW_KEY atau REG_OPENED_EXISTING_KEY.

Tampilkan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS. Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h.

Keterangan

Pembungkus RegCreateKeyTransacted ini memanggil fungsi .

RegDeleteKey

Menghapus subkuntang dan nilainya dari tampilan khusus platform yang ditentukan dari registri sebagai operasi yang ditransaksikan.

inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);

Parameter

hKey
Handel ke kunci registri terbuka.

lpSubKey
Nama kunci yang akan dihapus.

Tampilkan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS. Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h.

Keterangan

Pembungkus RegDeleteKeyTransacted ini memanggil fungsi .

RegOpenKeyEx

Membuka kunci registri yang ditentukan dan mengaitkannya dengan transaksi.

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

Parameter

hKey
Handel ke kunci registri terbuka.

lpSubKey
Nama subkuntang registri yang akan dibuka.

ulOptions
Parameter ini dicadangkan dan harus nol.

samDesired
Masker yang menentukan hak akses untuk kunci.

phkResult
Penunjuk ke variabel yang menerima handel ke kunci yang dibuka atau dibuat. Jika kunci bukan salah satu kunci registri yang telah ditentukan sebelumnya, panggil RegCloseKey fungsi setelah Anda selesai menggunakan handel.

Tampilkan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS. Jika fungsi gagal, nilai pengembalian adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h

Keterangan

Pembungkus RegOpenKeyTransacted ini memanggil fungsi .

Pemulihan

Meminta agar transaksi digulung balik.

inline BOOL Rollback();

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Pembungkus RollbackTransaction ini memanggil fungsi .

SetFileAttributes

Mengatur atribut untuk file atau direktori sebagai operasi yang ditransaksikan.

inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);

Parameter

lpFileName
Nama file atau direktori.

dwAttributes
Atribut file yang akan diatur untuk file. Untuk informasi selengkapnya, lihat SetFileAttributesTransacted.

Keterangan

Pembungkus SetFileAttributesTransacted ini memanggil fungsi .

Lihat juga

Komponen Desktop ATL COM

  • Last updated on