Platform SDK: Performance Monitoring

PdhReadRawLogRecord

The PdhReadRawLogRecord function reads the information in the specified binary trace log file.

PDH_STATUS PdhReadRawLogRecord(
  HLOG hLog,                
  FILETIME ftRecord,        
  PPDH_RAW_LOG_RECORD pRawLogRecord,
  LPDWORD pdwBufferLength   
);

Parameters

hLog
[in] A handle to the log file.
ftRecord
[in] The timestamp of the record to be read.
pRawLogRecord
[out] A pointer to a PDH_RAW_LOG_RECORD structure that receives the log file record information.
pdwBufferLength
[in] A pointer to a DWORD that receives the length of the pRawLogRecord buffer.

Return Values

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a PDH error status defined in PDHMsg.h.

Remarks

This function is intended to be used only with binary trace log files and is not to be used when reading CSV, TSV, Perfmon, and binary log files created by either the Windows NT System Monitor, the Windows NT and Windows 2000 Performance Monitors, or PDH interface functions. Use the PdhCollectQueryData function to do this.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Pdh.h.
  Library: Use Pdh.lib.

See Also

PDH_RAW_LOG_RECORD, PdhFormatFromRawValue,PdhCollectQueryData