Compartilhar via


Função GetNumberOfEventLogRecords (winbase.h)

Recupera o número de registros no log de eventos especificado.

Sintaxe

BOOL GetNumberOfEventLogRecords(
  [in]  HANDLE hEventLog,
  [out] PDWORD NumberOfRecords
);

Parâmetros

[in] hEventLog

Um identificador para o log de eventos aberto. A função OpenEventLog ou OpenBackupEventLog retorna esse identificador.

[out] NumberOfRecords

Um ponteiro para uma variável que recebe o número de registros no log de eventos especificado.

Valor de retorno

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

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

Observações

O registro mais antigo em um log de eventos não é necessariamente o número 1 do registro. Para determinar o número de registro mais antigo em um log de eventos, use a função GetOldestEventLogRecord.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winbase.h (inclua Windows.h)
biblioteca Advapi32.lib
de DLL Advapi32.dll
conjunto de API ext-ms-win-advapi32-eventlog-l1-1-1 (introduzido no Windows 10, versão 10.0.10240)

Consulte também

Funções de registro em log de eventos

GetOldestEventLogRecord

OpenBackupEventLog

OpenEventLog