Share via

Fungsi MsiEndTransaction (msi.h)

  • Artikel

Fungsi MsiEndTransaction dapat menerapkan atau mengembalikan semua instalasi milik transaksi yang dibuka oleh fungsi MsiBeginTransaction . Fungsi ini harus dipanggil oleh pemilik transaksi saat ini.

Windows Installer 4.0 dan yang lebih lama: Tidak didukung. Fungsi ini tersedia dimulai dengan Pemasang Windows 4.5.

Sintaks

UINT MsiEndTransaction(
  [in] DWORD dwTransactionState
);

Parameter

[in] dwTransactionState

Nilai parameter ini menentukan apakah alat penginstal melakukan atau mengembalikan semua penginstalan milik transaksi. Nilainya bisa menjadi salah satu dari berikut ini.

Nilai Makna
MSITRANSACTIONSTATE_ROLLBACK
 Melakukan Penginstalan Putar Kembali untuk membatalkan perubahan pada sistem milik transaksi yang dibuka oleh fungsi MsiBeginTransaction .
MSITRANSACTIONSTATE_COMMIT
 Menerapkan semua perubahan pada sistem milik transaksi. Menjalankan Tindakan Kustom Penerapan apa pun dan berkomitmen pada sistem setiap perubahan pada Win32 atau rakitan runtime bahasa umum. Menghapus skrip putar kembali, dan setelah menggunakan opsi ini, perubahan transaksi tidak dapat lagi dibatalkan dengan Penginstalan Putar Kembali.

Nilai kembali

Fungsi MsiEndTransaction mengembalikan nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 Transaksi hanya dapat diakhir oleh pemilik saat ini.
ERROR_INSTALL_FAILURE
 Penginstalan milik transaksi tidak dapat diselesaikan.
ERROR_INSTALL_ALREADY_RUNNING
 Penginstalan milik transaksi masih berlangsung.
ERROR_ROLLBACK_DISABLED
 Penginstalan milik transaksi tidak selesai. Selama penginstalan, tindakan DisableRollback menonaktifkan penginstalan putar kembali paket. Alat penginstal mengembalikan penginstalan hingga titik di mana pembatalan dinonaktifkan, dan fungsi mengembalikan kesalahan ini.

Persyaratan

Persyaratan 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.
Target Platform Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Beberapa Penginstalan Paket