PLOG_EVENT_ROUTINE función de devolución de llamada (resapi.h)

Artículo
03/05/2024

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-&gt;hResourceHandle,
                     LOG_ERROR,
                     L"Failed to start the specified service.\n" );

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

//  Message w/multiple arguments
    (g_pfnLogEvent)( pResourceEntry-&gt;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