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
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

PdhCloseQuery