PerfDeleteInstance function (perflib.h)
Deletes an instance of the counter set created by the PerfCreateInstance function. Providers use this function.
Syntax
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
Parameters
[in] Provider
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.
[in] InstanceBlock
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | perflib.h |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |