Fungsi SetupLogErrorA (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupLogError menulis pesan kesalahan ke file log. Ini dimaksudkan untuk digunakan selama penginstalan Windows, tetapi selalu tersedia. Ini tidak dimaksudkan untuk digunakan setelah sistem operasi diinstal - log peristiwa harus digunakan sebagai gantinya.

Sintaksis

WINSETUPAPI BOOL SetupLogErrorA(
  [in] LPCSTR      MessageString,
  [in] LogSeverity Severity
);

Parameter

[in] MessageString

Penunjuk ke string yang harus disimpan ke log Penyetelan. Pesan harus diakhir dengan kombinasi return-linefeed (\r\n). Anda harus menggunakan string null-terminated. String yang dihentikan null tidak boleh melebihi ukuran buffer tujuan. Pesan selalu disimpan ke log tindakan, setupact.log. Jika Tingkat Keparahan LogSevWarning, LogSevError, atau LogSevFatalError, Penyiapan juga menyimpan pesan ke log kesalahan, setuperr.log. Kedua log disimpan di direktori Windows.

[in] Severity

Tingkat keparahan pesan, salah satu hal berikut: LogSevInformation, LogSevWarning, LogSevError, atau LogSevFatalError.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

• Log tindakan ditujukan untuk merekam semua modifikasi yang dilakukan pada sistem selama penginstalan Windows.
• Log kesalahan hanya ditujukan untuk kesalahan selama penginstalan Windows.
• Parameter MessageString dapat diformat lebih lanjut dengan Penyiapan (meskipun sekarang tidak melakukan pemrosesan tambahan).
• Log kesalahan akan disajikan kepada pengguna di akhir penyiapan sistem.

Nota

Header setupapi.h mendefinisikan SetupLogError sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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 XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll
set API	ext-ms-win-setupapi-logging-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Functions

Gambaran Umum