PLOG_EVENT_ROUTINE Rückruffunktion (resapi.h)

Artikel
03/01/2024

Zeichnet ein Ereignis im Clusterprotokoll auf. Der PLOG_EVENT_ROUTINE Typ definiert einen Zeiger auf diese Funktion.

Syntax

PLOG_EVENT_ROUTINE PlogEventRoutine;

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

Parameter

[in] ResourceHandle

Behandeln Sie die Identifizierung der Ressource, die das Ereignis aufzeichnet. Der Wert für ResourceHandle sollte das Handle sein, das während des Open-Aufrufs für diese Ressource übergeben wurde.

[in] LogLevel

Wert, der von der LOG_LEVEL Enumeration aufgezählt wird, die die Protokollebene des Ereignisses darstellt und nur zu Informationszwecken dient. Die folgenden gültigen Werte werden in der Reihenfolge vom niedrigsten bis zum schwersten angezeigt.

LOG_INFORMATION (0)

Das Ereignis ist informal.

LOG_WARNING (1)

Das Ereignis meldet einen Fehler, der möglicherweise aufgetreten ist, aber es ist unsicher, ob ein Fehler tatsächlich aufgetreten ist.

LOG_ERROR (2)

Das Ereignis wirkt sich auf eine einzelne Komponente aus, andere Komponenten sind jedoch nicht betroffen, und die Integrität des restlichen Knotens wird nicht gefährdet.

LOG_SEVERE (3)

Das Ereignis meldet einen schwerwiegenden Fehler, der mehrere Komponenten betrifft, oder die Integrität des gesamten Systems wird kompromittiert oder als kompromittiert angesehen.

[in] FormatString

Unicode-Zeichenfolge mit Null-Endung, die die aufzuzeichnenden Informationen enthält. Diese Zeichenfolge muss das gleiche Format aufweisen wie die, die an die FormatMessage-Funktion übergeben wurde.

unnamedParam4

Rückgabewert

Keine

Bemerkungen

Die LogEvent-Rückruffunktion wird vom Ressourcenmonitor implementiert und von einer Ressourcen-DLL aufgerufen, um Ereignisse und Fehler an das Clusterprotokoll zu melden. Ressourcen-DLLs erhalten einen Zeiger auf die LogEvent-Rückruffunktion im LogEvent-Parameter auf ihre Starteinstiegspunktfunktion.

LogEvent schreibt keine Einträge in das Ereignisprotokoll. Um Ereignisse im Ereignisprotokoll zu melden, muss eine Ressourcen-DLL die ReportEvent-Funktion aufrufen.

Das Format der protokollierten Nachricht wird wie folgt angezeigt:

ResourceTypeName ResourceName: Nachricht

ResourceTypeName ist der Ressourcentyp, z. B. "Generische Anwendung". Der spezifische Ressourcenname ist der benutzerfreundliche Name für die bestimmte Ressource, und die Nachricht ist die Nachricht, die von der Ressourcen-DLL an den Ressourcenmonitor übermittelt wird.

Die Protokolleintragsgröße ist auf 500 Zeichen beschränkt.

Beispiele

Das folgende Beispiel basiert auf Code, der vom Clusterressourcentyp-Assistenten generiert wurde. Weitere Beispiele finden Sie unter Ressourcen-DLL-Beispiele.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h