Fungsi MsiEnableLogA (msi.h)

Artikel
11/20/2024

Fungsi MsiEnableLog mengatur mode log untuk semua penginstalan berikutnya yang dimulai dalam proses panggilan.

Sintaksis

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

Parameter

[in] dwLogMode

Menentukan mode log. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Nilai	Arti
INSTALLLOGMODE_FATALEXIT	Log keluar dari memori atau informasi keluar fatal.
INSTALLLOGMODE_ERROR	Mencatat pesan kesalahan.
INSTALLLOGMODE_EXTRADEBUG	Mengirim informasi penelusuran kesalahan tambahan, seperti menangani informasi pembuatan, ke file log. Windows 2000 dan Windows XP: Fitur ini tidak didukung.
INSTALLLOGMODE_WARNING	Mencatat pesan peringatan.
INSTALLLOGMODE_USER	Mencatat permintaan pengguna.
INSTALLLOGMODE_INFO	Mencatat pesan status yang tidak ditampilkan.
INSTALLLOGMODE_RESOLVESOURCE	Permintaan untuk menentukan lokasi sumber yang valid.
INSTALLLOGMODE_OUTOFDISKSPACE	Menunjukkan ruang disk yang tidak cukup.
INSTALLLOGMODE_ACTIONSTART	Mencatat awal tindakan penginstalan baru.
INSTALLLOGMODE_ACTIONDATA	Mencatat rekaman data dengan tindakan penginstalan.
INSTALLLOGMODE_COMMONDATA	Mencatat parameter untuk inisialisasi antarmuka pengguna.
INSTALLLOGMODE_PROPERTYDUMP	Mencatat nilai properti saat penghentian.
INSTALLLOGMODE_VERBOSE	Mencatat informasi dalam semua mode log lainnya, kecuali untuk INSTALLLOGMODE_EXTRADEBUG. Ini mengirimkan sejumlah besar informasi ke file log yang umumnya tidak berguna bagi pengguna. Dapat digunakan untuk dukungan teknis.
INSTALLLOGMODE_LOGONLYONERROR	Informasi pengelogan dikumpulkan tetapi kurang sering disimpan ke file log. Ini dapat meningkatkan performa beberapa instalasi, tetapi mungkin memiliki sedikit manfaat untuk penginstalan besar. File log dihapus ketika penginstalan berhasil. Jika penginstalan gagal, semua informasi pengelogan disimpan ke file log. Windows Installer 2.0: Mode log ini tidak tersedia.

[in] szLogFile

Menentukan string yang menyimpan jalur lengkap ke file log. Memasukkan null menonaktifkan pengelogan, dalam hal ini dwlogmode diabaikan. Jika jalur disediakan, maka dwlogmode tidak boleh nol.

[in] dwLogAttributes

Menentukan seberapa sering buffer log akan dibersihkan.

Nilai	Arti
INSTALLLOGATTRIBUTES_APPEND	Jika nilai ini diatur, alat penginstal menambahkan log yang ada yang ditentukan oleh szLogFile. Jika tidak diatur, log yang ada yang ditentukan oleh szLogFile ditimpa.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE	Memaksa buffer log untuk dibersihkan setelah setiap baris. Jika nilai ini tidak diatur, alat penginstal menghapus buffer log setelah 20 baris dengan memanggil FlushFileBuffers.

Mengembalikan nilai

Nilai	Arti
ERROR_INVALID_PARAMETER	Mode log yang tidak valid ditentukan.
ERROR_SUCCESS	Fungsi berhasil.

Komentar

Untuk deskripsi kebijakan Pengelogan, lihat Kebijakan Sistem.

Jalur ke lokasi file log harus sudah ada saat menggunakan fungsi ini. Alat Penginstal tidak membuat struktur direktori untuk file log.

Nota

Header msi.h mendefinisikan MsiEnableLog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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.0 atau Windows Installer 4.5 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. 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

Antarmuka dan Pengelogan

Pengelogan

Bagikan melalui