次の方法で共有


IScheduledEventProvider.Initialize Method

イベント プロバイダを初期化します。

名前空間: Microsoft.SqlServer.NotificationServices
アセンブリ: Microsoft.SqlServer.NotificationServices (microsoft.sqlserver.notificationservices.dll 内)

構文

'宣言
Sub Initialize ( _
    nsApplication As NSApplication, _
    providerName As String, _
    args As StringDictionary, _
    stopDelegate As StopHandler _
)
void Initialize (
    NSApplication nsApplication,
    string providerName,
    StringDictionary args,
    StopHandler stopDelegate
)
void Initialize (
    NSApplication^ nsApplication, 
    String^ providerName, 
    StringDictionary^ args, 
    StopHandler^ stopDelegate
)
void Initialize (
    NSApplication nsApplication, 
    String providerName, 
    StringDictionary args, 
    StopHandler stopDelegate
)
function Initialize (
    nsApplication : NSApplication, 
    providerName : String, 
    args : StringDictionary, 
    stopDelegate : StopHandler
)

パラメータ

  • nsApplication
    このイベント プロバイダがイベントを配信する Notification Services アプリケーションを表す NSApplication です。
  • providerName
    アプリケーション定義で指定した、イベント プロバイダの名前を表す String です。
  • args
    アプリケーション定義で指定した、初期化引数の名前と値を表す StringDictionary です。
  • stopDelegate
    プロバイダ ホストに対して終了を要求するため、イベント プロバイダがコールバックするときに使用できる StopHandler デリゲートです。

    イベント プロバイダは、Initialize メソッドが完了するまで初期化されません。初期化中に stopDelegate を呼び出しても、効果はありません。

解説

プロバイダ ホストはこのメソッドを呼び出して、初期化を実行する必要があることを定期的なイベント プロバイダに通知します。args パラメータには、イベント プロバイダを初期化するための引数が設定されています。イベント プロバイダ引数の詳細については、「ホストされるイベント プロバイダの定義」を参照してください。

args パラメータで指定された値を使用して、クラス変数を設定し、イベント プロバイダの実行準備をします。多くの場合、この操作では、イベント プロバイダが監視するイベント ソースに関する情報、およびそのイベント プロバイダで作成されるイベントを定義するイベント クラスに関する情報の設定を行います。

イベント プロバイダ ホストは、起動時に Initialize を呼び出します。イベント プロバイダは、初期化が完了したらすぐに処理を終了します。プロバイダ ホストは、Run または Terminate メソッドを呼び出す前に、必ず Initialize を呼び出します。

Initialize メソッドでは、5 分間でタイムアウトするウィンドウが表示されます。その時間内に初期化が完了しなかった場合、エラーのログが記録され、イベント プロバイダの Terminate メソッドが呼び出されます。

使用例

Initialize メソッドを実装する方法の例については、IScheduledEventProvider のトピックを参照してください。

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

IScheduledEventProvider Interface
IScheduledEventProvider Members
Microsoft.SqlServer.NotificationServices Namespace