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 结尾的 Unicode 字符串。 此字符串的格式必须与传递给 FormatMessage 函数的格式相同。
unnamedParam4
返回值
无
备注
LogEvent 回调函数由资源监视器实现，并由资源 DLL 调用，以向群集日志报告事件和错误。 资源 DLL 接收指向 LogEvent 参数中 LogEvent 回调函数的指针，指向其 Startup 入口点函数。
LogEvent 不会将条目写入事件日志。 若要在事件日志中报告事件，资源 DLL 必须调用 ReportEvent 函数。
记录的消息的格式如下所示：
ResourceTypeName ResourceName： 消息
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 );
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
| 目标平台 | Windows |
| 标头 | resapi.h |