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 错误代码。 以下是可能的值。
返回代码 | 说明 |
---|---|
|
一个或多个字符串缓冲区的大小不正确。 |
|
一个或多个计数器路径元素对于返回缓冲区长度而言太大。 |
|
无法分配临时内存缓冲区。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
库 |
|
DLL |
|