EventProvider.IsEnabled メソッド

定義

セッションでプロバイダーが有効にされているかどうかを判断します。Determines whether a session enabled the provider.

オーバーロード

IsEnabled(Byte, Int64)

なんらかのセッションが、プロバイダーから、指定されたイベントを要求しているかどうかを判断します。Determines whether any session is requesting the specified event from the provider.

IsEnabled()

プロバイダーを有効化するときに使用されたレベルやキーワードの値に関係なく、任意のセッションでプロバイダーが有効にされているかどうかを判断します。Determines whether any session enabled the provider, regardless of the level and keyword values used to enable the provider.

IsEnabled(Byte, Int64)

なんらかのセッションが、プロバイダーから、指定されたイベントを要求しているかどうかを判断します。Determines whether any session is requesting the specified event from the provider.

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

イベントに含まれる詳細レベル。Level of detail included in the event.

keywords
Int64

イベントのカテゴリを指定するビット マスク。Bit mask that specifies the event category. このマスクは、そのイベントに対してマニフェストで定義されたものと同じキーワード マスクであることが必要です。This mask should be the same keyword mask that is defined in the manifest for the event.

戻り値

Boolean

指定されたイベントをなんらかのセッションが要求している場合は true。それ以外の場合は falseIs true if any session is requesting the specified event; otherwise, false.

注釈

通常、プロバイダーは、セッションが指定されたイベントを要求したかどうかを判断するために、このメソッドを呼び出しません。プロバイダーはイベントを書き込むだけで、ETW はイベントがセッションに記録されるかどうかを判断します。Typically, a provider does not call this method to determine whether a session requested the specified event; the provider simply writes the event, and ETW determines whether the event is logged to a session. プロバイダーは、イベントを生成するために追加の処理を実行する必要がある場合に、この関数を呼び出すことができます。A provider may want to call this function if the provider needs to perform extra work to generate the event. この場合、セッションがイベントを要求したかどうかを判断するために、最初にこの関数を呼び出すと、リソースと時間が節約される可能性があります。In this case, calling this function first to determine if a session requested the event or not, may save resources and time.

適用対象

IsEnabled()

プロバイダーを有効化するときに使用されたレベルやキーワードの値に関係なく、任意のセッションでプロバイダーが有効にされているかどうかを判断します。Determines whether any session enabled the provider, regardless of the level and keyword values used to enable the provider.

public:
 bool IsEnabled();
public bool IsEnabled ();
member this.IsEnabled : unit -> bool
Public Function IsEnabled () As Boolean

戻り値

Boolean

プロバイダーが任意のセッションに対して有効にされている場合は true。それ以外の場合は falseIs true if the provider is enabled to any session; otherwise, false.

注釈

通常、プロバイダーは、このメソッドを呼び出して、プロバイダーがセッションによって有効になっているかどうかを判断しません。プロバイダーはイベントを書き込むだけで、ETW はイベントがセッションに記録されるかどうかを判断します。Typically, a provider does not call this method to determine whether the provider has been enabled by a session; the provider simply writes the event, and ETW determines whether the event is logged to the session. プロバイダーは、イベントを生成するために追加の処理を実行する必要がある場合に、この関数を呼び出すことができます。A provider may want to call this function if the provider needs to perform extra work to generate the event. この場合、最初にこの関数を呼び出すと、リソースと時間が節約される可能性があります。In this case, calling this function first may save resources and time.

適用対象