PMSetCounterValue

Windows NT only!

The PMSetCounterValue function sets the value of the specified counter.

long PMSetCounterValue(
  long          objIndex,     // index of counter's object
  long          counterIndex,      // index of the counter
  unsigned long newValue      // new value of the counter
);

 

Parameters

objIndex

Specifies the grouping object index. This index is returned by PMAddObject.

counterIndex

Specifies the counter index. This index is returned by PMAddCounter.

newValue

Specifies the new value of the counter.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

Use this function only if counters are currently in use.

If you do not manage the values of your counters, you can ask it. In this case you may call PMGetCounterValue.

Requirements

    Header: Declared in GSRoot.h
    Import Library: Link with GSRootImp.lib

See Also

Performance Monitor Manager Functions, PMAddObject, PMAddCounter, PMGetCounterValue