EventProvider.IsEnabled 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
确定会话是否启用了提供程序。
重载
| 名称 | 说明 |
|---|---|
| IsEnabled(Byte, Int64) |
确定任何会话是否正在从提供程序请求指定的事件。 |
| IsEnabled() |
确定提供程序是否启用了任何会话,而不考虑用于启用提供程序的级别和关键字值。 |
IsEnabled(Byte, Int64)
确定任何会话是否正在从提供程序请求指定的事件。
public:
bool IsEnabled(System::Byte level, long keywords);
public bool IsEnabled(byte level, long keywords);
member this.IsEnabled : byte * int64 -> bool
Public Function IsEnabled (level As Byte, keywords As Long) As Boolean
参数
- level
- Byte
事件中包含的详细信息级别。
- keywords
- Int64
指定事件类别的位掩码。 此掩码应与事件清单中定义的关键字掩码相同。
返回
如果 true 任何会话请求指定事件,则为 ;否则为 false。
注解
通常,提供程序不调用此方法来确定会话是否请求了指定的事件;提供程序只写入事件,ETW 确定事件是否记录到会话。 如果提供程序需要执行额外的工作来生成事件,则提供程序可能需要调用此函数。 在这种情况下,首先调用此函数以确定会话是否请求事件,可能会节省资源和时间。
适用于
IsEnabled()
确定提供程序是否启用了任何会话,而不考虑用于启用提供程序的级别和关键字值。
public:
bool IsEnabled();
public bool IsEnabled();
member this.IsEnabled : unit -> bool
Public Function IsEnabled () As Boolean
返回
如果 true 提供程序已启用任何会话,则为 ;否则为 false。
注解
通常,提供程序不调用此方法来确定提供程序是否已由会话启用;提供程序只是写入事件,ETW 确定事件是否记录到会话。 如果提供程序需要执行额外的工作来生成事件,则提供程序可能需要调用此函数。 在这种情况下,首先调用此函数可能会节省资源和时间。