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 錯誤碼。 以下是可能的值。
| 傳回碼 | Description |
|---|---|
|
一或多個字串緩衝區不是正確的大小。 |
|
一或多個計數器路徑元素太大，無法讓傳回緩衝區長度。 |
|
無法配置暫存記憶體緩衝區。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 程式庫 |
|
| DLL |
|