PLOG_EVENT_ROUTINE función de devolución de llamada (resapi.h)
Registra un evento en el registro del clúster. El tipo PLOG_EVENT_ROUTINE define un puntero a esta función.
Sintaxis
PLOG_EVENT_ROUTINE PlogEventRoutine;
void PlogEventRoutine(
[in] RESOURCE_HANDLE ResourceHandle,
[in] LOG_LEVEL LogLevel,
[in] LPCWSTR FormatString,
... unnamedParam4
)
{...}
Parámetros
[in] ResourceHandle
Controle la identificación del recurso que registra el evento. El valor de ResourceHandle debe ser el identificador pasado durante la llamada Open para este recurso.
[in] LogLevel
Valor enumerado por la enumeración LOG_LEVEL que representa el nivel de registro del evento y que es solo para información. Los siguientes valores válidos se muestran en orden de menos a más graves.
LOG_INFORMATION (0)
El evento es informativo.
LOG_WARNING (1)
El evento informa de un error que podría haber ocurrido, pero no es seguro si se produjo realmente un error.
LOG_ERROR (2)
El evento afecta a un solo componente, pero otros componentes no se ven afectados y la integridad del resto del nodo no está en peligro.
LOG_SEVERE (3)
El evento informa de un error grave que afecta a varios componentes, o la integridad de todo el sistema está en peligro o se cree que está en peligro.
[in] FormatString
Cadena Unicode terminada en NULL que incluye la información que se va a registrar. Esta cadena debe tener el mismo formato que el pasado a la función FormatMessage .
unnamedParam4
Valor devuelto
None
Observaciones
El Monitor de recursos implementa la función de devolución de llamada LogEvent y una DLL de recursos llama a ella para notificar eventos y errores en el registro del clúster. Los archivos DLL de recursos reciben un puntero a la función de devolución de llamada LogEvent del parámetro LogEvent a su función de punto de entrada de inicio .
LogEvent no escribe entradas en el registro de eventos. Para notificar eventos en el registro de eventos, un archivo DLL de recursos debe llamar a la función ReportEvent .
El formato del mensaje registrado aparece de la siguiente manera:
ResourceTypeName ResourceName: message
ResourceTypeName es el tipo de recurso, como "Aplicación genérica". El nombre de recurso específico es el nombre descriptivo del recurso específico y el mensaje es el mensaje entregado por el archivo DLL de recursos al Monitor de recursos.
El tamaño de entrada del registro está limitado a 500 caracteres.
Ejemplos
El ejemplo siguiente se basa en el código generado por el Asistente para tipos de recursos de clúster. Para obtener ejemplos adicionales, consulte Ejemplos de DLL de recursos.
// 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 );
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | resapi.h |