Función PdhReadRawLogRecord (pdh.h)

Lee la información del archivo de registro de seguimiento binario especificado.

Sintaxis

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

Parámetros

[in] hLog

Identificador del archivo de registro. La función PdhOpenLog o PdhBindInputDataSource devuelve este identificador.

[in] ftRecord

Marca de tiempo del registro que se va a leer. Si la marca de tiempo no coincide con un registro en el archivo de registro, la función devuelve el registro que tiene una marca de tiempo más cercana (pero no mayor que) la marca de tiempo especificada.

[out] pRawLogRecord

Búfer asignado por el autor de la llamada que recibe una estructura PDH_RAW_LOG_RECORD ; la estructura contiene la información del registro del archivo de registro. Se establece en NULL si pdwBufferLength es cero.

[in] pdwBufferLength

Tamaño del búfer pRawLogRecord , en TCHAR. Si es cero en la entrada, la función devuelve PDH_MORE_DATA y establece este parámetro en el tamaño de búfer necesario. Si el búfer es mayor que el tamaño necesario, la función establece este parámetro en el tamaño real del búfer que se usó. Si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario, no debe confiar en el tamaño devuelto para reasignar el búfer.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto	Descripción
PDH_INVALID_ARGUMENT	Un parámetro no es válido. Por ejemplo, en algunas versiones podría recibir este error si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario.
PDH_MORE_DATA	El búfer pRawLogRecord es demasiado pequeño para contener los elementos de ruta de acceso. Este valor devuelto se espera si pdwBufferLength es cero en la entrada. Si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario, no debe confiar en el tamaño devuelto para reasignar el búfer.
PDH_MEMORY_ALLOCATION_FAILURE	No se puede asignar memoria para completar la función.

Comentarios

Debe llamar a esta función dos veces, la primera vez que obtenga el tamaño de búfer necesario (establezca pRawLogRecord en NULL y pdwBufferLength en 0) y la segunda vez para obtener los datos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	pdh.h
Library	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PDH_RAW_LOG_RECORD

PdhCollectQueryData

PdhFormatFromRawValue