Fungsi SetupLogFileW (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 SetupLogFile menambahkan entri ke file log.

Sintaksis

WINSETUPAPI BOOL SetupLogFileW(
  [in] HSPFILELOG FileLogHandle,
  [in] PCWSTR     LogSectionName,
  [in] PCWSTR     SourceFilename,
  [in] PCWSTR     TargetFilename,
  [in] DWORD      Checksum,
  [in] PCWSTR     DiskTagfile,
  [in] PCWSTR     DiskDescription,
  [in] PCWSTR     OtherInfo,
  [in] DWORD      Flags
);

Parameter

[in] FileLogHandle

Tangani ke log file seperti yang dikembalikan oleh SetupInitializeFileLog. Pemanggil tidak boleh melewati SPFILELOG_QUERYONLY ketika file log diinisialisasi.

[in] LogSectionName

Penunjuk opsional ke nama untuk pengelompokan nama logis dalam file log. Anda harus menggunakan stringnullyang dihentikan . Diperlukan jika SPFILELOG_SYSTEMLOG tidak diteruskan ketika log file diinisialisasi. Jika tidak, parameter ini dapat NULL.

[in] SourceFilename

Nama file seperti yang ada pada media sumber tempat file diinstal. Nama ini harus dalam format apa pun yang bermakna bagi pemanggil. Anda harus menggunakan stringnullyang dihentikan .

[in] TargetFilename

Nama file seperti yang ada pada target. Nama ini harus dalam format apa pun yang bermakna bagi pemanggil. Anda harus menggunakan stringnullyang dihentikan .

[in] Checksum

Penunjuk opsional ke nilai checksum. Diperlukan untuk log sistem.

[in] DiskTagfile

Penunjuk opsional ke tagfile untuk media tempat file diinstal. Anda harus menggunakan stringnullyang dihentikan . String null-dihentikan tidak boleh melebihi ukuran buffer tujuan. Diabaikan untuk log sistem jika SPFILELOG_OEMFILE tidak ditentukan. Diperlukan untuk log sistem jika SPFILELOG_OEMFILE ditentukan. Jika tidak, parameter ini dapat NULL.

[in] DiskDescription

Penunjuk opsional ke deskripsi media yang dapat dibaca manusia tempat file diinstal. Anda harus menggunakan stringnullyang dihentikan . Diabaikan untuk log sistem jika SPFILELOG_OEMFILE tidak ditentukan dalam parameter Bendera . Diperlukan untuk log sistem jika SPFILELOG_OEMFILE ditentukan dalam parameter Bendera. Jika tidak, parameter ini dapat NULL.

[in] OtherInfo

Penunjuk opsional ke informasi tambahan yang akan dikaitkan dengan file. Anda harus menggunakan stringnullyang dihentikan . Parameter ini dapat null.

[in] Flags

Parameter ini dapat SPFILELOG_OEMFILE, yang bermakna hanya untuk log sistem dan menunjukkan bahwa file tidak disediakan oleh Microsoft. Parameter ini dapat digunakan untuk mengonversi entri file yang ada, seperti ketika OEM menimpa file sistem yang disediakan Microsoft.

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

Nota

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

Lihat juga

Functions

Gambaran Umum

SetupRemoveFileLogEntry