PdhVbAddCounter function
The PdhVbAddCounter function creates a counter entry in the specified query object, and returns a handle to that counter upon successful completion.
Important
The function that this topic describes may be altered or unavailable in the future. Instead, Microsoft recommends that you use the functions described in Performance Counters Functions.
Function PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle As Long _ ) As Long
Parameters
-
QueryHandle
-
ID of the query to which this counter is to be assigned. This value is returned by the PdhVbOpenQuery function.
-
CounterPath
-
Text string that specifies the name of the counter path to add to the query. The contents of this string must be a valid counter path, as obtained from the counter browser or other source.
-
CounterHandle
-
Unique reference that identifies this counter in the query. This variable must be initialized to zero before the function is called. It contains a valid value on return only if the function completes successfully.
Return value
If the function succeeds, it returns a Long integer equal to ERROR_SUCCESS and a new handle in the CounterHandle variable.
If the function fails, the return value is a system error code or a PDH error code. The following are possible values.
| Return code | Description |
|---|---|
|
One or more of the arguments is invalid or incorrect. |
|
A memory buffer could not be allocated. |
|
The query handle is not valid. |
|
The specified counter was not found. |
|
The specified object could not be found. |
|
A computer entry could not be created. |
|
An empty counter name path string was passed in. |
|
The calculation function for this counter could not be determined. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| Library |
|
| DLL |
|