Поделиться через

Функция PdhReadRawLogRecord (pdh.h)

  • Статья

Считывает сведения из указанного двоичного файла журнала трассировки.

Синтаксис

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

Параметры

[in] hLog

Дескриптор файла журнала. Функция PdhOpenLog или PdhBindInputDataSource возвращает этот дескриптор.

[in] ftRecord

Метка времени записи для чтения. Если метка времени не соответствует записи в файле журнала, функция возвращает запись, которая имеет метку времени, ближайшую (но не больше) к заданной метке времени.

[out] pRawLogRecord

Выделенный вызывающим объектом буфер, который получает PDH_RAW_LOG_RECORD структуру; Структура содержит сведения о записи файла журнала. Установите значение NULL , если pdwBufferLength равно нулю.

[in] pdwBufferLength

Размер буфера pRawLogRecord в TCHAR. Если входные данные равны нулю, функция возвращает PDH_MORE_DATA и задает для этого параметра требуемый размер буфера. Если размер буфера превышает требуемый размер, функция задает для этого параметра фактический размер использованного буфера. Если указанный размер входных данных больше нуля, но меньше требуемого размера, не следует полагаться на возвращаемый размер для перераспределения буфера.

Возвращаемое значение

Если функция завершается успешно, она возвращает ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой код системной ошибки или код ошибки PDH. Ниже приведены возможные значения.

Код возврата Описание
PDH_INVALID_ARGUMENT
 Недействительный параметр. Например, в некоторых выпусках эта ошибка может возникнуть, если указанный размер входных данных больше нуля, но меньше требуемого размера.
PDH_MORE_DATA
 Буфер pRawLogRecord слишком мал, чтобы содержать элементы пути. Это возвращаемое значение ожидается, если pdwBufferLength равно нулю на входных данных. Если указанный размер входных данных больше нуля, но меньше требуемого размера, не следует полагаться на возвращаемый размер для перераспределения буфера.
PDH_MEMORY_ALLOCATION_FAILURE
 Не удалось выделить память для выполнения функции.

Комментарии

Эту функцию следует вызывать дважды: первый раз, чтобы получить требуемый размер буфера (задайте для pRawLogRecordзначение NULL , а pdwBufferLength — 0), а второй раз — для получения данных.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header pdh.h
Библиотека Pdh.lib
DLL Pdh.dll

См. также раздел

PDH_RAW_LOG_RECORD

PdhCollectQueryData

PdhFormatFromRawValue