Función PdhUpdateLogFileCatalog (pdh.h)

  • Artículo

Sincroniza la información del catálogo de archivos de registro con los datos de rendimiento del archivo de registro.

Nota Esta función está obsoleta.
 

Sintaxis

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

Parámetros

[in] hLog

Identificador del archivo de registro que contiene el catálogo de archivos que se va a actualizar. Función PdhOpenLog .

Valor devuelto

Si la función se ejecuta 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_NOT_IMPLEMENTED
 Se especificó un identificador para un archivo de registro CSV o TSV. Estos tipos de archivo de registro no tienen catálogos.
PDH_UNKNOWN_LOG_FORMAT
 Se especificó un identificador para un archivo de registro con un formato desconocido.
PDH_INVALID_HANDLE
 El identificador no es válido.

Comentarios

El catálogo de archivos de registro actúa como índice para los registros de datos de rendimiento en el archivo de registro, lo que proporciona búsquedas más rápidas de registros individuales en el archivo.

Los catálogos deben actualizarse cuando se complete el proceso de recopilación de datos y se haya cerrado el archivo de registro. El catálogo se puede actualizar durante la recopilación de datos, pero esto puede interrumpir el proceso de registro de los datos de rendimiento porque la actualización de los catálogos puede llevar mucho tiempo.

Los archivos de registro de Perfmon, CSV y TSV no tienen catálogos. Especificar un identificador para estos tipos de archivo de registro dará como resultado un valor devuelto de PDH_NOT_IMPLEMENTED.

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

PdhGetLogFileSize

PdhUpdateLog