PdhVbGetCounterPathElements 函数

PdhVbGetCounterPathElements 函数将完全限定的性能计数器路径字符串解析为其各个元素。 每个字符串变量的大小必须相同， (BufferSize) ，并在此函数中使用之前对其进行维度化和初始化。

重要

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

函数 PdhVbGetCounterPathElements ( _ ByVal PathString As String， _ ByVal MachineName As String， _ ByVal ObjectName As String， _ ByVal InstanceName As String， _ ByVal ParentInstance As String， _ ByVal CounterName As String， _ ByVal BufferSize As Long _ ) As Long

参数

PathString

要分解为各个元素的计数器路径字符串。

MachineName

用于接收计算机名称的字符串。

ObjectName

用于接收对象名称的字符串。

InstanceName

用于接收实例名称的字符串（如果使用）。

ParentInstance

用于接收父实例的字符串（如果使用）。

CounterName

用于接收计数器名称的字符串。

BufferSize

用作此函数调用的参数的每个字符串变量的最大大小。

返回值

如果函数成功，则返回等于 ERROR_SUCCESS 的 Long 整数。

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

返回代码	说明
PDH_INVALID_ARGUMENT	一个或多个字符串缓冲区的大小不正确。
PDH_MORE_DATA	一个或多个计数器路径元素对于返回缓冲区长度而言太大。
PDH_MEMORY_ALLOCATION_FAILURE	无法分配临时内存缓冲区。

要求

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

另请参阅

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath