Fungsi TraceQueryInformation (evntrace.h)

Fungsi TraceQueryInformation menyediakan informasi tentang sesi pelacakan peristiwa.

Sintaks

ULONG WMIAPI TraceQueryInformation(
                  CONTROLTRACE_ID  TraceId,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Parameter

TraceId

[in] InformationClass

Kelas informasi yang akan dikueri. Informasi yang diambil kelas disertakan di bagian data yang diperluas dari peristiwa. Untuk daftar kelas informasi yang bisa Anda kueri, lihat enumerasi TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Penunjuk ke buffer untuk menerima data spesifik kelas informasi yang dikembalikan. Kelas informasi menentukan konten parameter ini. Misalnya, untuk kelas informasi TraceStackTracingInfo , parameter ini adalah array struktur CLASSIC_EVENT_ID . Struktur menentukan GUID peristiwa tempat pelacakan tumpukan diaktifkan. Array dibatasi hingga 256 elemen.

[in] InformationLength

Ukuran, dalam byte, data yang dikembalikan dalam buffer TraceInformation . Jika fungsi gagal, nilai ini menunjukkan ukuran buffer TraceInformation yang diperlukan.

[out, optional] ReturnLength

Penunjuk nilai yang menerima ukuran, dalam byte, dari data tertentu yang dikembalikan dalam buffer TraceInformation .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan 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

Fungsi TraceQueryInformation mengkueri pengaturan sesi pelacakan peristiwa dari sesi pelacakan. Panggil fungsi ini setelah memanggil StartTrace.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [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 dan Windows Server 2012
DLL	Sechost.dll pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll pada Windows 8 dan Windows Server 2012

Lihat juga

TRACE_QUERY_INFO_CLASS

TraceSetInformation