PdhVbOpenQuery function
The PdhVbOpenQuery function creates and initializes a unique query structure that is used to manage the collection of performance data.
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 PdhVbOpenQuery( _ ByVal QueryHandle As Long _ ) As Long
Parameters
-
QueryHandle
-
Variable that is cleared (equals 0) before the function is called and, if the function is successful, contains the unique ID of the query that is created and opened. This handle is used in the subsequent calls to other PDH functions to identify the query.
Return value
If the function succeeds, it returns a Long integer equal to ERROR_SUCCESS and a new handle in the QueryHandle 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 |
|---|---|
|
The argument is invalid or incorrect. |
|
A temporary memory buffer could not be allocated. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| Library |
|
| DLL |
|