Función PdhUpdateLogW (pdh.h)

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

Sintaxis

PDH_FUNCTION PdhUpdateLogW(
  [in] PDH_HLOG hLog,
  [in] LPCWSTR  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