Fungsi MsiBeginTransactionA (msi.h)

Artikel
11/20/2024

Fungsi MsiBeginTransaction mulai pemrosesan transaksi penginstalan beberapa paket dan mengembalikan pengidentifikasi untuk transaksi. Fungsi MsiEndTransaction mengakhiri transaksi.

Windows Installer 4.0 danyang lebih lama: Tidak didukung. Fungsi ini tersedia dimulai dengan Windows Installer 4.5.

Sintaksis

UINT MsiBeginTransactionA(
  [in]  LPCSTR    szName,
  [in]  DWORD     dwTransactionAttributes,
  [out] MSIHANDLE *phTransactionHandle,
  [out] HANDLE    *phChangeOfOwnerEvent
);

Parameter

[in] szName

Nama penginstalan beberapa paket.

[in] dwTransactionAttributes

Atribut penginstalan beberapa paket.

Nilai	Arti
0	Ketika 0 atau tidak ada nilai yang diatur, Penginstal Windows menutup UI dari penginstalan sebelumnya.
MSITRANSACTION_CHAIN_EMBEDDEDUI	Atur atribut ini untuk meminta agar Penginstal Windows tidak mematikan UI yang disematkan hingga transaksi selesai.

[out] phTransactionHandle

ID Transaksi adalah nilai MSIHANDLE yang mengidentifikasi transaksi. Hanya satu proses yang dapat memiliki transaksi pada satu waktu.

[out] phChangeOfOwnerEvent

Parameter ini mengembalikan handel ke peristiwa yang diatur ketika fungsi MsiJoinTransaction mengubah pemilik transaksi ke pemilik baru. Pemilik saat ini dapat menggunakan ini untuk menentukan kapan kepemilikan transaksi telah berubah. Meninggalkan transaksi tanpa pemilik akan mengembalikan transaksi.

Mengembalikan nilai

Fungsi MsiBeginTransaction mengembalikan nilai berikut.

Nilai	Arti
ERROR_INSTALL_SERVICE_FAILURE	Layanan penginstalan tidak dapat diakses. Fungsi ini memerlukan layanan Penginstal Windows.
ERROR_INSTALL_ALREADY_RUNNING	Hanya satu transaksi yang dapat dibuka pada sistem pada satu waktu. Fungsi mengembalikan kesalahan ini jika dipanggil saat transaksi lain sedang berjalan.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi .
ERROR_ROLLBACK_DISABLED	Penginstalan Putar Kembali telah dinonaktifkan oleh properti DISABLEROLLBACK atau kebijakan DisableRollback .

Komentar

Nota

Header msi.h mendefinisikan MsiBeginTransaction sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.5 di Windows Vista, Windows XP, Windows Server 2003, dan Windows Server 2008. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Penginstalan Beberapa Paket

Bagikan melalui