Fungsi SetupWriteTextLogError (setupapi.h)
Fungsi SetupWriteTextLogError menulis informasi tentang kesalahan khusus SetupAPI atau kesalahan sistem Win32 ke log teks SetupAPI.
Sintaks
WINSETUPAPI VOID SetupWriteTextLogError(
[in] SP_LOG_TOKEN LogToken,
[in] DWORD Category,
[in] DWORD LogFlags,
[in] DWORD Error,
[in] PCSTR MessageStr,
...
);
Parameter
[in] LogToken
Token log yang merupakan token log yang ditentukan sistem atau dikembalikan oleh SetupGetThreadLogToken.
[in] Category
Nilai jenis DWORD yang menunjukkan kategori peristiwa untuk entri log. Kategori peristiwa yang dapat ditentukan untuk entri log sama dengan yang dapat diaktifkan untuk log teks. Untuk daftar kategori peristiwa, lihat Mengaktifkan Kategori Peristiwa untuk Log Teks SetupAPI.
[in] LogFlags
Nilai jenis DWORD yang merupakan bitwise ATAU nilai bendera, yang menentukan hal berikut:
- Tingkat peristiwa untuk entri log. Tingkat peristiwa yang dapat ditentukan untuk entri log sama dengan yang dapat diaktifkan untuk log teks. Untuk daftar bendera tingkat peristiwa, lihat Mengatur Tingkat Peristiwa untuk Log Teks.
- Apakah akan menyertakan stempel waktu dalam entri log. Nilai bendera stempel waktu TXTLOG_TIMESTAMP.
- Perubahan, jika ada, ke kedalaman indentasi bagian dan entri log saat ini. Untuk informasi tentang cara menggunakan bendera indentasi, lihat Menulis Entri Log Inden.
[in] Error
Kode kesalahan khusus SetupAPI atau kode kesalahan Win32. Kode kesalahan khusus SetupAPI tercantum di Setupapi.h. Kode kesalahan Win32 tercantum dalam Winerror.h.
[in] MessageStr
Penunjuk ke string konstanta yang dihentikan NULL yang berisi string format yang kompatibel dengan printf, yang menentukan pesan yang diformat untuk disertakan dalam entri log.
...
Daftar parameter yang dipisahkan koma yang cocok dengan penentu format dalam string format yang disediakan oleh MessageStr.
Nilai kembali
Tidak ada
Keterangan
Jika aplikasi penginstalan memiliki kode kesalahan khusus SetupAPI atau kode kesalahan Win32 yang terkait dengan kesalahan penginstalan, aplikasi dapat memanggil SetupWriteTextLogError alih-alih SetupWriteTextLog untuk menulis dua entri ke dalam log teks. Entri pertama akan sama dengan yang ditulis oleh SetupWriteTextLog dan entri kedua akan mencatat kode kesalahan dan deskripsi kesalahan yang mudah digunakan.
Token log, kategori peristiwa, dan bendera yang disediakan pemanggil memengaruhi pengoperasian SetupWriteTextLogError adalah cara yang sama seperti yang dijelaskan untuk SetupWriteTextLog.
SetupWriteTextLogError menulis entri log pertama dalam format berikut:
entry-prefixtime_stampindentasi kategori formatted-message
SetupWriteTextLogError menulis entri log kedua dalam format berikut:
entry-prefixtime_stampkategoriindentasiKesalahan:error-numbererror-description
Di mana:
- Bidang entry-prefix, time-stamp, category, indentation, dan formatted-message sama dengan yang dijelaskan dalam Format Isi Bagian Log Teks.
- Bidang nomor kesalahan berisi nomor kesalahan.
- Bidang deskripsi kesalahan berisi deskripsi kesalahan yang mudah digunakan.
Untuk informasi selengkapnya tentang operasi SetupWriteTextLogError, lihat Memanggil SetupWriteTextLogError.
Untuk informasi selengkapnya tentang token log, lihat Token Log.
Untuk informasi selengkapnya tentang menggunakan token log, lihat Mengatur dan Mendapatkan Token Log untuk Utas.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |