Fungsi SetupInitializeFileLogA (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 SetupInitializeFileLog menginisialisasi file untuk merekam operasi penginstalan dan hasil. Ini bisa menjadi log sistem, di mana sistem melacak file yang diinstal sebagai bagian dari Windows, atau file lainnya.

Sintaksis

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

Parameter

[in] LogFileName

Penunjuk opsional ke nama file untuk digunakan sebagai file log. Anda harus menggunakan stringnullyang dihentikan . Parameter LogFileName harus ditentukan jika bendera tidak menyertakan SPFILELOG_SYSTEMLOG. Parameter LogFileName tidak boleh ditentukan jika bendera menyertakan SPFILELOG_SYSTEMLOG. Parameter ini dapat null.

[in] Flags

Mengontrol inisialisasi file log. Parameter ini bisa menjadi kombinasi dari nilai berikut.

SPFILELOG_SYSTEMLOG

Gunakan log file sistem. Pengguna harus menjadi Administrator untuk menentukan opsi ini kecuali SPFILELOG_QUERYONLY ditentukan dan LogFileName tidak ditentukan. Jangan tentukan SPFILELOG_SYSTEMLOG dalam kombinasi dengan SPFILELOG_FORCENEW.

SPFILELOG_FORCENEW

Jika file log ada, timpa file tersebut. Jika file log ada dan bendera ini tidak ditentukan, file baru apa pun yang diinstal ditambahkan ke daftar dalam file log yang ada. Jangan tentukan dalam kombinasi dengan SPFILELOG_SYSTEMLOG.

SPFILELOG_QUERYONLY

Buka file log hanya untuk kueri.

Mengembalikan nilai

Fungsi mengembalikan handel ke file log jika berhasil. Jika tidak, nilai pengembalian INVALID_HANDLE_VALUE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Komentar

Nota

Header setupapi.h mendefinisikan SetupInitializeFileLog 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

SetupLogFile

SetupTerminateFileLog