PdhUpdateLogA 函数（pdh.h）

收集当前查询的计数器数据，并将数据写入日志文件。

语法

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

[in] hLog

要更新的单个日志文件的句柄。 PdhOpenLog 函数返回此句柄。

[in] szUserString

以 Null 结尾的字符串，其中包含要添加到数据记录的用户定义注释。字符串不能为空。

如果函数成功，它将返回ERROR_SUCCESS。

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

返回代码	描述
PDH_INVALID_HANDLE	日志文件句柄无效。
PDH_INVALID_ARGUMENT	szUserString 参数中传递了空字符串。

如果要从另一个日志文件更新日志文件，则来自其他日志文件的注释不会迁移。

注意

pdh.h 标头将 PdhUpdateLog 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。