Fungsi PdhReadRawLogRecord (pdh.h)

Artikel
03/08/2023

Membaca informasi dalam file log jejak biner yang ditentukan.

Sintaks

PDH_FUNCTION PdhReadRawLogRecord(
  [in]  PDH_HLOG            hLog,
  [in]  FILETIME            ftRecord,
  [out] PPDH_RAW_LOG_RECORD pRawLogRecord,
  [in]  LPDWORD             pdwBufferLength
);

Parameter

[in] hLog

Tangani ke file log. Fungsi PdhOpenLog atau PdhBindInputDataSource mengembalikan handel ini.

[in] ftRecord

Stempel waktu rekaman yang akan dibaca. Jika stempel waktu tidak cocok dengan rekaman dalam file log, fungsi mengembalikan rekaman yang memiliki stempel waktu yang paling dekat dengan (tetapi tidak lebih besar dari) stempel waktu yang diberikan.

[out] pRawLogRecord

Buffer yang dialokasikan penelepon yang menerima struktur PDH_RAW_LOG_RECORD ; struktur berisi informasi rekaman file log. Atur ke NULL jika pdwBufferLength adalah nol.

[in] pdwBufferLength

Ukuran buffer pRawLogRecord , dalam TCHAR. Jika nol pada input, fungsi mengembalikan PDH_MORE_DATA dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika buffer lebih besar dari ukuran yang diperlukan, fungsi mengatur parameter ini ke ukuran buffer aktual yang digunakan. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk mengalokasikan kembali buffer.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH. Berikut ini adalah nilai yang mungkin.

Menampilkan kode	Deskripsi
PDH_INVALID_ARGUMENT	Parameter tidak valid. Misalnya, pada beberapa rilis, Anda dapat menerima kesalahan ini jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan.
PDH_MORE_DATA	Buffer pRawLogRecord terlalu kecil untuk berisi elemen jalur. Nilai yang dikembalikan ini diharapkan jika pdwBufferLength adalah nol pada input. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk mengalokasikan kembali buffer.
PDH_MEMORY_ALLOCATION_FAILURE	Tidak dapat mengalokasikan memori untuk menyelesaikan fungsi.

Keterangan

Anda harus memanggil fungsi ini dua kali, pertama kali untuk mendapatkan ukuran buffer yang diperlukan (atur pRawLogRecord ke NULL dan pdwBufferLength ke 0), dan kedua kalinya untuk mendapatkan data.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	pdh.h
Pustaka	Pdh.lib
DLL	Pdh.dll

Lihat juga

PDH_RAW_LOG_RECORD

PdhCollectQueryData

PdhFormatFromRawValue

Bagikan melalui