Fungsi MsiEnableLogA (msi.h)

  • Artikel

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

Sintaks

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

Parameter

[in] dwLogMode

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

Nilai Makna
INSTALLLOGMODE_FATALEXIT
 Keluar dari memori atau informasi keluar yang 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 lebih jarang 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 dihapus.

Nilai Makna
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 akan 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.

Nilai kembali

Nilai Makna
ERROR_INVALID_PARAMETER
 Mode log tidak valid ditentukan.
ERROR_SUCCESS
 Fungsi berhasil.

Keterangan

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.

Catatan

Header msi.h mendefinisikan MsiEnableLog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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

Lihat juga

Fungsi Antarmuka dan Pengelogan

Pengelogan