PdhVbAddCounter 函式
PdhVbAddCounter函式會在指定的查詢物件中建立計數器專案，並在成功完成時傳回該計數器的控制碼。
重要
本主題描述的函式未來可能會改變或無法使用。 相反地，Microsoft 建議您使用 效能計數器函式中所述的函式。
函式 PdhVbAddCounter ( _ ByVal QueryHandle As Long， _ ByVal CounterPath As String， _ ByVal CounterHandle As Long _ ) Long
參數
-
QueryHandle
-
要指派此計數器之查詢的識別碼。 PdhVbOpenQuery函式會傳回此值。
-
CounterPath
-
指定要加入查詢之計數器路徑名稱的文字字串。 此字串的內容必須是有效的計數器路徑，如從計數器瀏覽器或其他來源取得。
-
CounterHandle
-
識別查詢中這個計數器的唯一參考。 呼叫函式之前，此變數必須初始化為零。 只有在函式成功完成時，才會在傳回時包含有效的值。
傳回值
如果函式成功，它會傳回等於 ERROR_SUCCESS 的 Long 整數，以及 CounterHandle 變數中的新控制碼。
如果函式失敗，傳回值為 系統錯誤碼 或 PDH 錯誤碼。 以下是可能的值。
| 傳回碼 | Description |
|---|---|
|
一或多個引數無效或不正確。 |
|
無法配置記憶體緩衝區。 |
|
查詢控制碼無效。 |
|
找不到指定的計數器。 |
|
找不到指定的物件。 |
|
無法建立電腦專案。 |
|
傳入空的計數器名稱路徑字串。 |
|
無法判斷這個計數器的計算函數。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 程式庫 |
|
| DLL |
|