Fungsi EvtGetExtendedStatus (winevt.h)

Artikel
08/27/2023

Mendapatkan pesan teks yang berisi informasi kesalahan yang diperluas untuk kesalahan saat ini.

Sintaks

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Parameter

[in] BufferSize

Ukuran buffer Buffer , dalam karakter.

[in] Buffer

Buffer string yang dialokasikan penelepon yang akan menerima informasi kesalahan yang diperluas. Anda dapat mengatur parameter ini ke NULL untuk menentukan ukuran buffer yang diperlukan.

[out] BufferUsed

Ukuran, dalam karakter, dari buffer yang dialokasikan pemanggil yang digunakan fungsi atau ukuran buffer yang diperlukan jika fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER.

Menampilkan nilai

Nilai yang dikembalikan ERROR_SUCCESS jika panggilan berhasil; jika tidak, kode kesalahan Win32.

Keterangan

Anda harus memanggil fungsi ini pada utas yang menghasilkan kesalahan dan sebelum memanggil fungsi Log Peristiwa Windows lainnya.

Fungsi EvtQuery dan EvtSubscribe dapat memberikan informasi kesalahan yang diperluas jika ada masalah dengan JalurX yang ditentukan. Misalnya, informasi kesalahan dapat mengidentifikasi karakter di JalurX tempat kesalahan penguraian terjadi. Untuk menerima informasi kesalahan yang diperluas untuk XPath yang salah format, Anda tidak dapat menentukan bendera EvtQueryTolerateQueryErrors saat memanggil EvtQuery atau EvtSubscribe.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winevt.h
Pustaka	Wevtapi.lib
DLL	Wevtapi.dll

Bagikan melalui