Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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->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 );
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 |