PdhVbGetOneCounterPath 函数

PdhVbGetOneCounterPath 函数显示一个对话框，允许用户浏览可用的性能计数器并选择一个计数器。 所选计数器在 PathString 变量中返回。 在调用此函数之前，必须对 PathString 变量进行维度化和初始化，并且维度大小必须由 PathLength 变量指示。

重要

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

函数 PdhVbGetOneCounterPath ( _ ByVal PathString As String， _ ByVal PathLength As Long， _ ByVal DetailLevel As Long， _ ByVal CaptionString As String _ ) As Long

parameters

PathString

用于接收用户选择的计数器路径的初始化字符串变量。

PathLength

初始化的 PathString 的长度。

DetailLevel

要显示在对话框中的计数器的类型。 此参数的取值可为下列值之一：

值	含义
PERF_DETAIL_ADVANCED	高级用户可能理解的计数器，以及新手-用户计数器。
PERF_DETAIL_EXPERT	专家用户和软件开发人员可能理解的计数器，以及面向新手和高级用户的计数器。
PERF_DETAIL_NOVICE	仅新手用户可能理解的计数器。
PERF_DETAIL_WIZARD	系统中的所有计数器。

CaptionString

包含将在对话框的描述文字栏中显示的文本的字符串变量。

返回值

函数返回写入 PathString 缓冲区的字符数。

要求

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

另请参阅

PdhVbCreateCounterPathList

PdhVbGetCounterPathElements

PdhVbGetCounterPathFromList