Export (0) Print
Expand All
Expand Minimize

PerfDeleteInstance function

Deletes an instance of the counter set created by the PerfCreateInstance function. Providers use this function.

Syntax


ULONG PerfDeleteInstance(
  _In_  HANDLE hProvider,
  _In_  PPERF_COUNTERSET_INSTANCE InstanceBlock
);

Parameters

hProvider [in]

The handle of the provider. Use the handle variable that the CTRPP tool generated for you. For the name of the variable, see the symbol attribute of the provider element.

Windows Vista:  The PerfStartProvider function returns the handle.

InstanceBlock [in]

A PERF_COUNTERSET_INSTANCE structure that contains the instance of the counter set to delete.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a system error code.

Remarks

If the provider process terminates abnormally, all allocated instances will be released.

The provider determines when it deletes an instance. If the counter data is more static, the provider can delete an instance at cleanup time. For example, the number of processors on a computer would be considered static, so a provider that provides counter data for processors could delete an instance for each processor on the computer at cleanup time. For counters that are more dynamic, such as disk or process counters, the providers would delete the instances in response to a USB device being removed or a process being terminated.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Perflib.h

Library

Advapi32.lib

DLL

Advapi32.dll

See also

PerfCreateInstance
PerfQueryInstance

 

 

Community Additions

ADD
Show:
© 2014 Microsoft