Compartir a través de


Función PdhUpdateLogA (pdh.h)

Recopila datos de contador para la consulta actual y escribe los datos en el archivo de registro.

Sintaxis

PDH_FUNCTION PdhUpdateLogA(
  [in] PDH_HLOG hLog,
  [in] LPCSTR   szUserString
);

Parámetros

[in] hLog

Identificador de un único archivo de registro que se va a actualizar. La función PdhOpenLog devuelve este identificador.

[in] szUserString

Cadena terminada en NULL que contiene un comentario definido por el usuario que se va a agregar al registro de datos. La cadena no puede estar vacía.

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_INVALID_HANDLE
El identificador del archivo de registro no es válido.
PDH_INVALID_ARGUMENT
Se pasó una cadena vacía en el parámetro szUserString .

Comentarios

Si va a actualizar un archivo de registro desde otro archivo de registro, los comentarios del otro archivo de registro no se migran.

Ejemplos

Para obtener un ejemplo, vea Escribir datos de rendimiento en un archivo de registro.

Nota

El encabezado pdh.h define PdhUpdateLog como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog