UpdateHeapTrace
Fungsi ini memperbarui sesi pelacakan timbunan yang ada dengan serangkaian PID baru, peristiwa stackwalking, atau perubahan sesi ETW lainnya.
ULONG
WINAPI
UpdateHeapTrace(
_Inout_ PEVENT_TRACE_PROPERTIES Properties,
_In_z_ LPCWSTR wszSessionName,
_In_reads_opt_(cPids) const ULONG Pids[],
_In_ ULONG cPids,
_In_reads_opt_(cStackTracingEventIds) const STACK_TRACING_EVENT_ID StackTracingEventIds[],
_In_ ULONG cStackTracingEventIds
);
Parameter
TraceHandle [out]
Menyimpan handel ke sesi pelacakan peristiwa. Parameter ini diatur ke nol jika handel tidak valid. Parameter ini tidak boleh dibandingkan dengan INVALID_HANDLE_VALUE. Jangan gunakan handel ini jika fungsi gagal.
Properti [masuk, keluar]
Penunjuk ke struktur EVENT_TRACE_PROPERTIES dengan properti yang diperbarui untuk sesi. Lihat fungsi ControlTrace dengan ControlCode EVENT_TRACE_CONTROL_UPDATE untuk detail tentang anggota struktur ini mana yang dapat ditentukan.
wszSessionName[in]
Nama sesi pelacakan timbunan yang akan diperbarui. Ini harus menjadi nama yang sama yang diteruskan ke StartHeapTrace.
Pids [in]
Array ID proses untuk mengaktifkan pelacakan timbunan.
cPids [masuk, keluar]
Ukuran array Pids.
StackTracingEventIds [in]
Array struktur STACK_TRACING_EVENT_ID yang menentukan aktivitas tumpukan timbunan mana yang harus diaktifkan. Bisa NULL.
cStackTracingEventIds [in]
Ukuran array StackTracingEventIds.
Tampilkan Nilai
ERROR_SUCCESS menunjukkan keberhasilan.
Nilai kesalahan yang mungkin dijelaskan dalam tabel berikut ini.
| Nilai Kesalahan | Deskripsi |
|---|---|
ERROR_ALREADY_EXISTS |
Hanya satu instans pencatat kernel yang berjalan pada sistem. Jika fungsi ini mencoba untuk memulai setelah komponen lain memulai pengelogan kernel, kesalahan ini mungkin dikembalikan. |
ERROR_INVALID_FLAGS |
Mungkin menunjukkan bahwa ada bendera pelacakan yang tidak valid di Properties.EnableFlags. |
ERROR_OUT_OF_MEMORY |
Mungkin menunjukkan kegagalan mengalokasikan memori untuk EVENT_TRACE_PROPERTIES. |
Jika fungsi gagal karena alasan selain yang tercantum, kode kesalahan sistem dikembalikan.
Keterangan
Tidak ada