PLOG_EVENT_ROUTINE 콜백 함수(resapi.h)

클러스터 로그에 이벤트를 기록합니다. PLOG_EVENT_ROUTINE 형식은 이 함수에 대한 포인터를 정의합니다.

구문

PLOG_EVENT_ROUTINE PlogEventRoutine;

void PlogEventRoutine(
  [in] RESOURCE_HANDLE ResourceHandle,
  [in] LOG_LEVEL LogLevel,
  [in] LPCWSTR FormatString,
       ... unnamedParam4
)
{...}

매개 변수

[in] ResourceHandle

이벤트를 기록하는 리소스 식별을 처리합니다. ResourceHandle 값은 이 리소스에 대한 Open 호출 중에 전달된 핸들이어야 합니다.

[in] LogLevel

이벤트의 로그 수준을 나타내고 정보 전용인 LOG_LEVEL 열거형으로 열거된 값입니다. 다음 유효한 값은 최소에서 가장 심각한 값으로 순서대로 표시됩니다.

LOG_INFORMATION(0)

이벤트는 정보입니다.

LOG_WARNING (1)

이벤트가 발생했을 수 있는 오류를 보고하고 있지만 실제로 오류가 발생했는지 여부는 불확실합니다.

LOG_ERROR (2)

이벤트는 단일 구성 요소에 영향을 주지만 다른 구성 요소는 영향을 받지 않으며 나머지 노드 의 무결성은 손상되지 않습니다.

LOG_SEVERE (3)

이벤트는 여러 구성 요소에 영향을 주는 심각한 오류를 보고하거나 전체 시스템의 무결성이 손상되거나 손상된 것으로 추정됩니다.

[in] FormatString

기록할 정보를 포함하는 Null로 종료된 유니코드 문자열입니다. 이 문자열은 FormatMessage 함수에 전달된 형식과 동일한 형식이어야 합니다.

unnamedParam4

반환 값

없음

설명

LogEvent 콜백 함수는 리소스 모니터에 의해 구현되며 리소스 DLL에 의해 호출되어 이벤트 및 오류를 클러스터 로그에 보고합니다. 리소스 DLL은 LogEvent 매개 변수의 LogEvent 콜백 함수에 대한 포인터를 시작 진입점 함수에 수신합니다.

LogEvent 는 이벤트 로그에 항목을 쓰지 않습니다. 이벤트 로그에서 이벤트를 보고하려면 리소스 DLL이 ReportEvent 함수를 호출해야 합니다.

기록된 메시지의 형식은 다음과 같이 표시됩니다.

ResourceTypeName ResourceName: message

ResourceTypeName 은 "제네릭 애플리케이션"과 같은 리소스 유형입니다. 특정 리소스 이름은 특정 리소스에 대한 사용자 친화적인 이름이며, 메시지는 리소스 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 );

요구 사항

추가 정보

LOG_LEVEL

열기

ReportEvent

리소스 DLL 콜백 함수

Startup 클래스