Função RegisterManageableLogClient (clfsmgmtw32.h)

  • Artigo

A função RegisterManageableLogClient registra um cliente no gerenciador de logs. Um cliente pode especificar se deseja receber notificações usando retornos de chamada ou ter as notificações enfileiradas para recuperação usando ReadLogNotification.

Sintaxe

CLFSUSER_API BOOL RegisterManageableLogClient(
  [in] HANDLE                    hLog,
  [in] PLOG_MANAGEMENT_CALLBACKS pCallbacks
);

Parâmetros

[in] hLog

O identificador para o log a ser registrado. Somente um registro por abertura exclusiva do log é permitido.

[in] pCallbacks

Especifica os retornos de chamada para os quais o cliente está se registrando. Os retornos de chamada válidos são enumerados por LOG_MANAGEMENT_CALLBACKS. Em vez disso, especifique zero para notificações de fila.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um cliente pode cancelar o registro fechando o identificador de log ou chamando DeregisterManageableLogClient.

Exemplos

Para obter um exemplo que usa essa função, consulte Criando um arquivo de log.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho clfsmgmtw32.h
Biblioteca Clfsw32.lib
DLL Clfsw32.dll

Confira também

DeregisterManageableLogClient

LOG_MANAGEMENT_CALLBACKS