Fungsi EvtGetLogInfo (winevt.h)

Artikel
03/04/2024

Mendapatkan informasi tentang saluran atau file log.

Sintaks

BOOL EvtGetLogInfo(
  [in]  EVT_HANDLE          Log,
  [in]  EVT_LOG_PROPERTY_ID PropertyId,
  [in]  DWORD               PropertyValueBufferSize,
  [in]  PEVT_VARIANT        PropertyValueBuffer,
  [out] PDWORD              PropertyValueBufferUsed
);

Parameter

[in] Log

Handel ke saluran atau file log yang dikembalikan fungsi EvtOpenLog .

[in] PropertyId

Pengidentifikasi properti yang akan diambil. Untuk daftar pengidentifikasi properti, lihat enumerasi EVT_LOG_PROPERTY_ID .

[in] PropertyValueBufferSize

Ukuran buffer PropertyValueBuffer , dalam byte.

[in] PropertyValueBuffer

Buffer yang dialokasikan penelepon yang akan menerima nilai properti. Buffer berisi objek EVT_VARIANT . Anda dapat mengatur parameter ini ke NULL untuk menentukan ukuran buffer yang diperlukan.

[out] PropertyValueBufferUsed

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

Nilai kembali

Mengembalikan kode/nilai	Deskripsi
TRUE	Fungsi berhasil.
FALSE	Fungsi gagal. Untuk mendapatkan kode kesalahan, panggil fungsi GetLastError .

Keterangan

Anda bisa mendapatkan informasi lengkap untuk saluran Operasional dan Admin atau file .evtx; namun, untuk saluran Debug dan Analitik atau file .etl, Anda tidak bisa mendapatkan informasi untuk properti EvtLogFull, EvtLogOldestRecordNumber, dan EvtLogNumberOfLogRecords.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

EvtOpenLog

Bagikan melalui