Fungsi SetupWriteTextLogInfLine (setupapi.h)

Artikel
08/26/2023

Fungsi SetupWriteTextLogInfLine menulis entri log dalam log teks SetupAPI yang berisi teks baris file INF tertentu.

Sintaks

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

Parameter

[in] LogToken

Token log yang merupakan token log yang ditentukan sistem atau dikembalikan oleh SetupGetThreadLogToken.

[in] Flags

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 SetupAPI.
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] InfHandle

Handel ke file INF yang menyertakan baris teks yang akan ditulis ke log teks. Handel ke file INF diperoleh dengan memanggil SetupOpenInfFile, yang didokumenkan dalam Platform SDK.

[in] Context

Penunjuk ke konteks file INF yang menentukan baris teks yang akan ditulis ke log teks. Konteks file INF untuk baris diperoleh dengan memanggil fungsi SetupFindXxxLine . Untuk informasi tentang file INF dan konteks file INF, lihat informasi yang disediakan di Platform SDK tentang menggunakan file INF, mendapatkan konteks file INF, dan struktur INFCONTEXT.

Nilai kembali

Tidak ada

Keterangan

SetupWriteTextLogInfLine menulis entri log dalam format berikut:

entry-prefixtime-stampinf:indentationinf-line-text(inf-file-namelineline-number)

Di mana:

Bidang awalan entri dan stempel waktu sama dengan yang dijelaskan dalam Format Isi Bagian Log Teks.
Bidang teks baris-inf berisi teks baris file INF yang ditentukan.
Bidang inf-file-name berisi nama file INF yang berisi baris file INF yang ditentukan.
Bidang nomor baris berisi nomor baris dari baris yang ditentukan dalam file INF.

Token log dan bendera yang disediakan pemanggil memengaruhi pengoperasian SetupWriteTextLogInfLine dengan cara yang sama seperti yang dijelaskan untuk SetupWriteTextLog dan SetupWriteTextLogError. Selain itu, SetupWriteTextLogInfLine menggunakan kategori peristiwa TXTLOG_INF.

Untuk informasi umum tentang menulis entri log di log teks SetupAPI, lihat SetupAPI Logging (Windows Vista).

Untuk informasi selengkapnya tentang operasi SetupWriteTextLogInfLine, lihat Memanggil SetupWriteTextLogInfLine.

Untuk informasi selengkapnya tentang berbagai jenis 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
DLL	Setupapi.dll

Lihat juga

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError

Bagikan melalui