PdhVbUpdateLog 函数

PdhVbUpdateLog 函数更新当前查询并将新数据写入日志文件。 此函数调用 PdhUpdateLog。

重要

本主题介绍的函数将来可能会更改或不可用。 相反，Microsoft 建议你使用 性能计数器函数中所述的函数。

函数 PdhVbUpdateLog ( _ ByVal hLog As PDH_HLOG， _ ByVal szUserString As LPCTSTR _ )

parameters

hLog [in]

要更新的日志文件的句柄。 此句柄由 PdhVbOpenLog 函数返回。

szUserString [in]

指向字符串的指针，该字符串指定要添加到日志文件的数据。 这通常用于日志文件中的注释。

返回值

如果函数成功，则返回 0。

如果函数失败，则返回值为 系统错误代码 或 PDH 错误代码。 下面是可能的值。

返回代码	说明
PDH_INSUFFICIENT_BUFFER	请求的数据大于提供的缓冲区。 无法返回请求的数据。
PDH_INVALID_ARGUMENT	一个或多个字符串缓冲区的大小不正确。
PDH_INVALID_HANDLE	句柄不是有效的 PDH 对象。
PDH_LOG_FILE_OPEN_ERROR	无法打开指定的日志文件。
PDH_FILE_NOT_FOUND	找不到指定的文件。

备注

必须有当前打开的查询，并且必须在调用此函数之前将所需的计数器添加到其中。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
库	Pdh.lib
DLL	Pdh.dll

另请参阅

PdhUpdateLog

PdhVbGetLogFileSize

PdhVbOpenLog