PLOG_EVENT_ROUTINE

クラスター ログにイベントを記録します。PLOG_EVENT_ROUTINE 型は、この関数へのポインターを定義します。

LogEvent コールバック関数は リソース モニターによって実装され、リソース DLL がクラスター ログにイベントやエラーを報告するために呼び出します。リソース DLL は、LogEvent コールバック関数へのポインターを、Startup エントリ ポイント関数の LogEvent パラメーターで受け取ります。

LogEvent はイベント ログにエントリを書き込みません。イベント ログにイベントを報告するには、リソース DLL は ReportEvent 関数を呼び出す必要があります。

記録されるメッセージの形式は次のとおりです。

ResourceTypeName ResourceName: message

ResourceTypeName は「Generic Application」などのリソースの種類です。ResourceName は個々のリソースのわかりやすい名前であり、message はリソース DLL がリソース モニターに渡したメッセージです。

ログ エントリのサイズは 500 文字に制限されています。

例

次の例は、クラスター リソース タイプ ウィザードによって生成されたコードに基づいています。その他の例については、リソース DLL のサンプルを参照してください。

//  The following parameters are assumed to be already defined:
//  g_pfnLogEvent   Stores the address of the LogEvent callback
//                  function passed to the DLL in the
//                  Startup entry point.
//  pResourceEntry  Stores resource instance data.
//  MY_SVCNAME      Stores the name of a service.
//  nStatus         Result

//  Log the fact that an attempt to start a service has failed.

//  Basic message
    (g_pfnLogEvent)( pResourceEntry->hResourceHandle,
                     LOG_ERROR,
                     L"Failed to start the specified service.\n" );

//  Message w/string argument
    (g_pfnLogEvent)( pResourceEntry->hResourceHandle,
                     LOG_ERROR,
                     L"OnlineThread: Failed to start the '%1' service.\n",
                     MY_SVCNAME );

//  Message w/multiple arguments
    (g_pfnLogEvent)( pResourceEntry->hResourceHandle,
                     LOG_ERROR,
                     L"OnlineThread: Failed to start the '%1' service. Error: %2!u!.\n",
                     MY_SVCNAME,
                     nStatus );