Edit

Share via

PdhOpenQueryH function (pdh.h)

  • Article

Creates a new query that is used to manage the collection of performance data.

This function is identical to the PdhOpenQuery function, except that it supports the use of handles to data sources.

Syntax

PDH_FUNCTION PdhOpenQueryH(
  [in]  PDH_HLOG   hDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

Parameters

[in] hDataSource

Handle to a data source returned by the PdhBindInputDataSource function.

[in] dwUserData

User-defined value to associate with this query. To retrieve the user data later, call the PdhGetCounterInfo function and access the dwQueryUserData member of PDH_COUNTER_INFO.

[out] phQuery

Handle to the query. You use this handle in subsequent calls.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a system error code or a PDH error code.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header pdh.h
Library Pdh.lib
DLL Pdh.dll

See also

PdhBindInputDataSource