UnregisterTraceGuids 函数 (evntrace.h)

  • 项目

UnregisterTraceGuids 函数注销使用 RegisterTraceGuids 注册的经典 (Windows 2000 样式) ETW 事件跟踪提供程序。

语法

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE 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

另请参阅

RegisterTraceGuids