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 |
|---|---|
| PDH_INVALID_ARGUMENT | The argument is invalid or incorrect. |
| PDH_MEMORY_ALLOCATION_FAILURE | 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 | Pdh.lib |
| DLL | Pdh.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
