共用方式為


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

參數

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