PdhBrowseCountersHA function (pdh.h)
Displays a Browse Counters dialog box that the user can use to select one or more counters that they want to add to the query.
This function is identical to the PdhBrowseCounters function, except that it supports the use of handles to data sources.
Syntax
PDH_FUNCTION PdhBrowseCountersHA(
[in] PPDH_BROWSE_DLG_CONFIG_HA pBrowseDlgData
);
Parameters
[in] pBrowseDlgData
A PDH_BROWSE_DLG_CONFIG_H structure that specifies the behavior of the dialog box.
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.
Remarks
Note that the dialog box can return PDH_DIALOG_CANCELLED if bSingleCounterPerDialog is FALSE and the user clicks the Close button, so your error handling would have to account for this.
Note
The pdh.h header defines PdhBrowseCountersH as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
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 |