PLOG_EVENT_ROUTINE funzione di callback (resapi.h)

Articolo
03/08/2023

Registra un evento nel log del cluster. Il tipo PLOG_EVENT_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PLOG_EVENT_ROUTINE PlogEventRoutine;

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

Parametri

[in] ResourceHandle

Gestire l'identificazione della risorsa che registra l'evento. Il valore per ResourceHandle deve essere l'handle passato durante la chiamata Open per questa risorsa.

[in] LogLevel

Valore enumerato dall'enumerazione LOG_LEVEL che rappresenta il livello di log dell'evento e che è solo per informazioni. I valori validi seguenti vengono visualizzati in ordine da minimo a più grave.

LOG_INFORMATION (0)

L'evento è informativo.

LOG_WARNING (1)

L'evento segnala un errore che potrebbe essere successo, ma è incerto se si è verificato un errore.

LOG_ERROR (2)

L'evento influisce su un singolo componente, ma altri componenti non sono interessati e l'integrità del resto del nodo non viene compromessa.

LOG_SEVERE (3)

L'evento segnala un errore grave che influisce su più componenti o l'integrità dell'intero sistema viene compromessa o si ritiene che venga compromessa.

[in] FormatString

Stringa Unicode con terminazione null che include le informazioni da registrare. Questa stringa deve essere nello stesso formato di quella passata alla funzione FormatMessage .

unnamedParam4

Valore restituito

nessuno

Osservazioni

La funzione di callback LogEvent viene implementata da Monitoraggio risorse e viene chiamata da una DLL di risorse per segnalare eventi ed errori al log del cluster. Le DLL delle risorse ricevono un puntatore alla funzione di callback LogEvent nel parametro LogEvent nella funzione Punto di ingresso di avvio .

LogEvent non scrive voci nel registro eventi. Per segnalare gli eventi nel registro eventi, una DLL di risorse deve chiamare la funzione ReportEvent .

Il formato del messaggio registrato viene visualizzato come segue:

ResourceTypeName ResourceName: messaggio

ResourceTypeName è il tipo di risorsa, ad esempio "Applicazione generica". Il nome specifico della risorsa è il nome descrittivo per la risorsa specifica e il messaggio è il messaggio recapitato dalla DLL di risorse al Monitoraggio risorse.

Le dimensioni della voce di log sono limitate a 500 caratteri.

Esempio

L'esempio seguente si basa sul codice generato dalla Creazione guidata tipo di risorsa cluster. Per altri esempi, vedere Esempi di DLL delle risorse.

//  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 );

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	resapi.h