Fungsi CreateTransactionManager (ktmw32.h)

Artikel
08/24/2023

Membuat objek manajer transaksi (TM) baru dan mengembalikan handel dengan akses yang ditentukan.

Sintaks

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Parameter

[in, optional] lpTransactionAttributes

SECURITY_ATTRIBUTES transaksi (ACL) untuk objek TM.

[in, optional] LogFileName

Nama aliran file log. Jika aliran tidak ada di log, aliran akan dibuat. Untuk membuat TM yang volatil, parameter ini harus NULL dan CreateOptions harus menentukan TRANSACTION_MANAGER_VOLATILE, manajer transaksi ini dianggap volatil.

[in, optional] CreateOptions

Atribut opsional apa pun untuk TM baru.

Nilai	Makna
TRANSACTION_MANAGER_VOLATILE	Menunjukkan bahwa TM volatil, dan tidak melakukan pemulihan.

[in, optional] CommitStrength

Dipesan; tentukan nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke manajer transaksi.

Jika fungsi gagal, nilai yang dikembalikan adalah INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Daftar berikut mengidentifikasi kemungkinan kode kesalahan:

Keterangan

Segera setelah memanggil fungsi ini, Anda harus memanggil RecoverTransactionManager.

Jika manajer transaksi Anda volatil, semua manajer sumber daya Anda juga harus volatil.

Anda harus memanggil RecoverTransactionManager setelah membuat TM agar TM berfungsi dengan benar.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	ktmw32.h
Pustaka	Ktmw32.lib
DLL	Ktmw32.dll

Lihat juga

Fungsi Manajer Transaksi Kernel

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES

Share via