PdhVbGetDoubleCounterValue function

The PdhVbGetDoubleCounterValue function returns the current value of the specified counter as a double-precision floating point value. You should check CounterStatus before using the returned number, because the counter may not be valid when it is read. To check the counter status, call the PdhVbIsGoodStatus function.

Important

The function that this topic describes may be altered or unavailable in the future. Instead, Microsoft recommends that you use the functions described in Performance Counters Functions.

Function PdhVbGetDoubleCounterValue( _ ByVal CounterHandle As Long, _ ByRef CounterStatus As Long _ ) As Double

Parameters

CounterHandle

ID of the counter whose current value is to be read.

CounterStatus

Variable in which the current status of the counter value is returned to the caller. The returned data value is valid if and only if the value returned in CounterStatus is PDH_CSTATUS_VALID_DATA or PDH_CSTATUS_NEW_DATA (see PDH error codes). If the value returned in CounterStatus is any other value, do not use the data.

Return value

The function returns the double-precision floating point value of the current counter, computed and formatted as defined by the counter type.

Requirements

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

See also

PdhVbIsGoodStatus