Fungsi EventSetInformation (evntprov.h)

Mengonfigurasi penyedia peristiwa ETW.

Sintaks

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

Parameter

[in] RegHandle

Handel pendaftaran penyedia peristiwa. Ini adalah handel yang dikembalikan oleh EventRegister.

[in] InformationClass

EVENT_INFO_CLASS nilai yang menentukan operasi konfigurasi yang akan dilakukan pada penyedia peristiwa.

[in] EventInformation

Penunjuk ke buffer yang berisi data yang akan digunakan saat mengonfigurasi penyedia peristiwa. Format data dalam buffer ini tergantung pada nilai yang ditentukan dalam parameter InformationClass .

Nilai ini mungkin NULL jika InformationLength adalah nol.

[in] InformationLength

Ukuran (dalam byte) data dalam buffer EventInformation .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

• ERROR_INVALID_PARAMETER: Parameter salah. Misalnya, kesalahan ini dikembalikan jika parameter RegHandle bukan handel pendaftaran penyedia yang valid, jika EventInformationadalah NULL tetapi InformationLength bukan nol, atau jika InformationLength yang ditentukan tidak valid untuk InformationClass yang diberikan.
• ERROR_NOT_SUPPORTED: Permintaan tidak didukung. Kesalahan ini dikembalikan jika parameter InformationClass bukan nilai yang dikenali.
• Lainnya: Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Persyaratan

Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	evntprov.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

EVENT_INFO_CLASS

EventRegister