PdhOpenQuery (VB)

The Visual Basic PdhOpenQuery function creates and initializes a unique query structure that is used to manage the collection of performance data.

PdhOpenQuery(
  ByRef QueryHandle as Long)  
as Long
 

Parameters

QueryHandle

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

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 PDH error status defined in pdhdefs.txt. The following are possible error values:

PDH_INVALID_ARGUMENT

The argument is invalid or incorrect.

PDH_MEMORY_ALLOCATION_FAILURE

A temporary memory buffer could not be allocated.

See Also

Performance Data Helper Overview, Performance Data Functions