PdhOpenQuery function
Creates a new query that is used to manage the collection of performance data.
To use handles to data sources, use the PdhOpenQueryH function.
Syntax
PDH_STATUS PdhOpenQuery( _In_ LPCTSTR szDataSource, _In_ DWORD_PTR dwUserData, _Out_ PDH_HQUERY *phQuery );
Parameters
- szDataSource [in]
-
Null-terminated string that specifies the name of the log file from which to retrieve performance data. If NULL, performance data is collected from a real-time data source.
- dwUserData [in]
-
User-defined value to associate with this query. To retrieve the user data later, call PdhGetCounterInfo and access the dwQueryUserData member of PDH_COUNTER_INFO.
- phQuery [out]
-
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.
Examples
For an example, see Reading Performance Data from a Log File or Writing Performance Data to a Log File.
Requirements
|
Minimum supported client | Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names | PdhOpenQueryW (Unicode) and PdhOpenQueryA (ANSI) |
See also
Send comments about this topic to Microsoft
Build date: 10/26/2012
