UnregisterTraceGuids 函数 (evntrace.h)
UnregisterTraceGuids 函数注销使用 RegisterTraceGuids 注册的经典 (Windows 2000 样式) ETW 事件跟踪提供程序。
语法
ULONG WMIAPI UnregisterTraceGuids(
[in] TRACEGUID_HANDLE RegistrationHandle
);
参数
[in] RegistrationHandle
事件跟踪提供程序的句柄,从先前对 RegisterTraceGuids 函数的调用获取。
返回值
如果函数成功,则返回值为 ERROR_SUCCESS。
如果函数失败,则返回值为 系统错误代码之一。 下面是一些常见错误及其原因。
ERROR_INVALID_PARAMETER
RegistrationHandle 参数未指定已注册提供程序的句柄或为 NULL。
注解
提供程序调用此函数。
事件跟踪提供程序必须以前通过调用 RegisterTraceGuids 函数进行注册。
重要
在 DLL 或驱动程序卸载之前,必须注销 DLL 或驱动程序创建的所有注册句柄。 如果未取消注册提供程序,则 ETW 尝试调用提供程序的回调时将发生崩溃。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | evntrace.h |
Library | Advapi32.lib |
DLL | Advapi32.dll |