PdhBrowseCounters function

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_STATUS PdhBrowseCounters(
  _In_ PPDH_BROWSE_DLG_CONFIG pBrowseDlgData
);

Parameters

pBrowseDlgData [in]

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Pdh.h

Library

Pdh.lib

DLL

Pdh.dll

Unicode and ANSI names

PdhBrowseCountersW (Unicode) and PdhBrowseCountersA (ANSI)

See also

CounterPathCallBack
PDH_BROWSE_DLG_CONFIG
PdhBrowseCountersH

 

 

Show: