PLOG_EVENT_ROUTINE função de retorno de chamada (resapi.h)
Registra um evento no log do cluster. O tipo PLOG_EVENT_ROUTINE define um ponteiro para essa função.
Sintaxe
PLOG_EVENT_ROUTINE PlogEventRoutine;
void PlogEventRoutine(
[in] RESOURCE_HANDLE ResourceHandle,
[in] LOG_LEVEL LogLevel,
[in] LPCWSTR FormatString,
... unnamedParam4
)
{...}
Parâmetros
[in] ResourceHandle
Manipule a identificação do recurso que está gravando o evento. O valor de ResourceHandle deve ser o identificador passado durante a chamada Open para esse recurso.
[in] LogLevel
Valor enumerado pela enumeração LOG_LEVEL que representa o nível de log do evento e que é apenas para informações. Os valores válidos a seguir são mostrados na ordem de menos para mais grave.
LOG_INFORMATION (0)
O evento é informativo.
LOG_WARNING (1)
O evento está relatando uma falha que pode ter acontecido, mas é incerto se uma falha realmente ocorreu.
LOG_ERROR (2)
O evento afeta um único componente, mas outros componentes não são afetados e a integridade do restante do nó não é comprometida.
LOG_SEVERE (3)
O evento está relatando uma falha grave que afeta vários componentes ou a integridade de todo o sistema está comprometida ou acredita-se que esteja comprometida.
[in] FormatString
Cadeia de caracteres Unicode terminada em nulo que inclui as informações a serem registradas. Essa cadeia de caracteres deve estar no mesmo formato que a passada para a função FormatMessage .
unnamedParam4
Retornar valor
Nenhum
Comentários
A função de retorno de chamada LogEvent é implementada pelo Monitor de Recursos e é chamada por uma DLL de recurso para relatar eventos e erros ao log do cluster. As DLLs de recurso recebem um ponteiro para a função de retorno de chamada LogEvent no parâmetro LogEvent para sua função de ponto de entrada de inicialização .
LogEvent não grava entradas no log de eventos. Para relatar eventos no log de eventos, uma DLL de recurso deve chamar a função ReportEvent .
O formato da mensagem registrada é exibido da seguinte maneira:
ResourceTypeName ResourceName: mensagem
ResourceTypeName é o tipo de recurso, como "Aplicativo Genérico". O nome do recurso específico é o nome amigável do recurso específico e a mensagem é a mensagem entregue pela DLL do recurso ao Monitor de Recursos.
O tamanho da entrada de log é limitado a 500 caracteres.
Exemplos
O exemplo a seguir baseia-se no código gerado pelo Assistente de Tipo de Recurso de Cluster. Para obter exemplos adicionais, consulte Exemplos de DLL de recurso.
// 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 | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de Destino | Windows |
| Cabeçalho | resapi.h |