PdhBrowseCountersA function (pdh.h)

Article
02/22/2024

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.

To use handles to data sources, use the PdhBrowseCountersH function.

Syntax

PDH_FUNCTION PdhBrowseCountersA(
  [in] PPDH_BROWSE_DLG_CONFIG_A pBrowseDlgData
);

Parameters

[in] pBrowseDlgData

A PDH_BROWSE_DLG_CONFIG 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.

For information on using this function, see Browsing Counters.

Examples

For an example, see Browsing Performance Counters.

Note

The pdh.h header defines PdhBrowseCounters as an alias which 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 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