Memanggil SetupWriteTextLog

SetupWriteTextLog menambahkan satu entri dengan informasi tentang peristiwa penginstalan ke log teks SetupAPI.

Seperti yang dijelaskan dalam Format Isi Bagian Log Teks, format entri log terdiri dari bidang berikut:

entry_prefix time_stamp event_category indentation formatted_message

Untuk memanggil SetupWriteTextLog, aplikasi menyediakan informasi berikut:

• Token log untuk bagian dalam log teks yang diperoleh dengan memanggil SetupGetThreadLogToken, atau salah satu token log yang ditentukan sistem. Jika token log dikaitkan dengan bagian log teks, SetupWriteTextLog menulis entri log di bagian tersebut. Jika tidak, SetupWriteTextLog menambahkan entri log ke bagian log yang tidak disertakan dalam bagian log teks. Selain itu, apakah SetupWriteTextLog menulis entri log, dan ke log teks mana SetupWriteTextLog menulis entri, tergantung pada nilai token log yang ditentukan sistem.

  Untuk informasi selengkapnya tentang token log, lihat Menyetel dan Mendapatkan Token Log untuk Utas.

• Salah satu kategori peristiwa yang dijelaskan dalam Mengaktifkan Kategori Peristiwa untuk Log Teks. Jika kategori peristiwa untuk entri diaktifkan untuk log teks, SetupWriteTextLog menambahkan entri ke log teks; jika tidak, SetupWriteTextLog tidak menulis entri ke log teks.

• Nilai flag yang merupakan operasi OR bitwise dari konstanta yang didefinisikan sistem yang menentukan tingkat event, kedalaman indentasi, serta apakah akan menyertakan stempel waktu. Tingkat peristiwa dijelaskan dalam Mengatur Tingkat Peristiwa untuk Log Teks. Jika tingkat peristiwa yang diatur untuk log teks lebih besar dari atau sama dengan tingkat peristiwa untuk entri, SetupWriteTextLog menulis entri log ke log teks; jika tidak, SetupWriteTextLog tidak menulis entri log ke log teks. Dengan menggunakan indentasi, pesan yang diformat dapat diatur untuk membuat informasi di bagian lebih mudah dibaca dan dipahami. Untuk informasi selengkapnya, lihat Menulis Entri Log Inden.

• String format yang kompatibel dengan printf yang memformat pesan dan daftar variabel yang dipisahkan koma yang mengikuti string format.

• Daftar variabel yang dipisahkan koma, yang nilainya diformat oleh string format yang kompatibel dengan printf.

Untuk contoh tentang cara memanggil SetupWriteTextLog untuk mencatat informasi tentang peristiwa yang bukan kesalahan atau peringatan, lihat Menulis Entri Log Informasi.

Untuk contoh tentang cara memanggil SetupWriteTextLog untuk mencatat informasi tentang kesalahan atau peringatan, lihat Menulis Kesalahan atau Entri Log Peringatan.