PdhVbAddCounter 函数

PdhVbAddCounter 函数在指定的查询对象中创建计数器条目，并在成功完成时返回该计数器的句柄。

重要

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

函数 PdhVbAddCounter ( _ ByVal QueryHandle As Long， _ ByVal CounterPath As String， _ ByVal CounterHandle As Long _ ) As Long

参数

QueryHandle

要向其分配此计数器的查询的 ID。 此值由 PdhVbOpenQuery 函数返回。

CounterPath

指定要添加到查询的计数器路径的名称的文本字符串。 此字符串的内容必须是从计数器浏览器或其他源获取的有效计数器路径。

CounterHandle

在查询中标识此计数器的唯一引用。 在调用函数之前，必须将此变量初始化为零。 仅当函数成功完成时，它才包含返回时的有效值。

返回值

如果函数成功，它将返回一个等于 ERROR_SUCCESS 的 Long 整数，并在 CounterHandle 变量中返回一个新句柄。

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

返回代码	说明
PDH_INVALID_ARGUMENT	一个或多个参数无效或不正确。
PDH_MEMORY_ALLOCATION_FAILURE	无法分配内存缓冲区。
PDH_INVALID_HANDLE	查询句柄无效。
PDH_CSTATUS_NO_COUNTER	找不到指定的计数器。
PDH_CSTATUS_NO_OBJECT	找不到指定的对象。
PDH_CSTATUS_NO_MACHINE	无法创建计算机条目。
PDH_CSTATUS_BAD_COUNTERNAME	传入了空的计数器名称路径字符串。
PDH_FUNCTION_NOT_FOUND	无法确定此计数器的计算函数。

要求

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

另请参阅

PdhVbOpenQuery