Bagikan melalui

Fungsi TraceSetInformation (evntrace.h)

  • Artikel

Fungsi TraceSetInformation mengonfigurasi pengaturan sesi pelacakan peristiwa.

Sintaks

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Parameter

[in] SessionHandle

Menangani sesi pelacakan peristiwa yang akan dikonfigurasi. Fungsi StartTrace mengembalikan handel ini saat pelacakan baru dimulai. Untuk mendapatkan handel pelacakan yang ada, gunakan ControlTrace untuk mengkueri properti pelacakan berdasarkan nama jejak lalu dapatkan handel dari bidang Wnode.HistoricalContext dari data yang dikembalikan EVENT_TRACE_PROPERTIES .

[in] InformationClass

Kelas informasi untuk mengaktifkan atau menonaktifkan. Informasi yang diambil kelas disertakan di bagian data yang diperluas dari peristiwa tersebut. Untuk daftar kelas informasi yang dapat Anda aktifkan, lihat enumerasi TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Penunjuk ke data spesifik kelas informasi. Kelas informasi menentukan konten parameter ini.

[in] InformationLength

Ukuran, dalam byte, data dalam buffer TraceInformation .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

  • ERROR_BAD_LENGTH

    Program mengeluarkan perintah tetapi panjang perintah salah. Kesalahan ini dikembalikan jika parameter InformationLength kurang dari ukuran minimum.

  • ERROR_INVALID_PARAMETER

    Parameter salah.

  • ERROR_NOT_SUPPORTED

    Permintaan tidak didukung.

  • Lainnya

    Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Panggil fungsi ini setelah memanggil StartTrace.

Jika parameter InformationClass diatur ke TraceStackTracingInfo, memanggil fungsi ini memungkinkan pelacakan tumpukan peristiwa kernel yang ditentukan. Panggilan berikutnya ke fungsi ini menimpa daftar peristiwa kernel sebelumnya yang pelacakan tumpukannya diaktifkan. Untuk menonaktifkan pelacakan tumpukan, panggil fungsi ini dengan InformationClass yang diatur ke TraceStackTracingInfo dan InformationLength diatur ke 0.

Bagian data yang diperluas dari peristiwa akan menyertakan tumpukan panggilan. Kelas StackWalk_Event MOF menentukan tata letak data yang diperluas.

Biasanya, pada komputer 64-bit, Anda tidak dapat menangkap tumpukan kernel dalam konteks tertentu ketika kesalahan halaman tidak diizinkan. Untuk mengaktifkan berjalan tumpukan kernel pada x64, atur DisablePagingExecutive nilai registri Manajemen Memori ke 1. Nilai DisablePagingExecutive registri terletak di bawah kunci registri berikut: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Ini hanya boleh dilakukan untuk tujuan diagnosis sementara karena meningkatkan penggunaan memori sistem.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header evntrace.h
Pustaka Sechost.lib pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.lib pada Windows 8, Windows Server 2012, Windows 7 dan Windows Server 2008 R2
DLL Sechost.dll pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll pada Windows 8, Windows Server 2012, Windows 7, dan Windows Server 2008 R2

Lihat juga

TRACE_QUERY_INFO_CLASS

TraceQueryInformation