Funzione ReadEventLogA (winbase.h)

Articolo
03/03/2024

Legge il numero specificato di voci dal registro eventi specificato. La funzione può essere usata per leggere le voci di log in ordine cronologico o inverso cronologico.

Sintassi

BOOL ReadEventLogA(
  [in]  HANDLE hEventLog,
  [in]  DWORD  dwReadFlags,
  [in]  DWORD  dwRecordOffset,
  [out] LPVOID lpBuffer,
  [in]  DWORD  nNumberOfBytesToRead,
  [out] DWORD  *pnBytesRead,
  [out] DWORD  *pnMinNumberOfBytesNeeded
);

Parametri

[in] hEventLog

Handle nel registro eventi da leggere. La funzione OpenEventLog restituisce questo handle.

[in] dwReadFlags

Usare i valori del flag seguenti per indicare come leggere il file di log. Questo parametro deve includere uno dei valori seguenti (i flag sono reciprocamente esclusivi).

Valore	Significato
EVENTLOG_SEEK_READ 0x0002	Iniziare a leggere dal record specificato nel parametro dwRecordOffset . Questa opzione potrebbe non funzionare con file di log di grandi dimensioni se la funzione non può determinare le dimensioni del file di log. Per informazioni dettagliate, vedere l'articolo della Knowledge Base, 177199.
EVENTLOG_SEQUENTIAL_READ 0x0001	Leggere i record in sequenza. Se si tratta della prima operazione di lettura, i flag di EVENTLOG_FORWARDS_READ EVENTLOG_BACKWARDS_READ determinano prima il record letto.

È necessario specificare uno dei flag seguenti per indicare la direzione per le operazioni di lettura successive (i flag sono reciprocamente esclusivi).

Valore	Significato
EVENTLOG_FORWARDS_READ 0x0004	Il log viene letto in ordine cronologico (meno recente e più recente). Valore predefinito.
EVENTLOG_BACKWARDS_READ 0x0008	Il log viene letto in ordine cronologico inverso (più recente al meno recente).

[in] dwRecordOffset

Numero di record della voce di log in cui deve iniziare l'operazione di lettura. Questo parametro viene ignorato a meno che dwReadFlags includa il flag di EVENTLOG_SEEK_READ .

[out] lpBuffer

Buffer allocato dall'applicazione che riceverà una o più strutture EVENTLOGRECORD . Questo parametro non può essere NULL, anche se il parametro nNumberOfBytesToRead è zero.

La dimensione massima di questo buffer è 0x7ffff byte.

[in] nNumberOfBytesToRead

Dimensioni del buffer lpBuffer , in byte. Questa funzione leggerà quante voci di log si adattano al buffer; la funzione non restituirà voci parziali.

[out] pnBytesRead

Puntatore a una variabile che riceve il numero di byte letti dalla funzione.

[out] pnMinNumberOfBytesNeeded

Puntatore a una variabile che riceve le dimensioni necessarie del buffer lpBuffer . Questo valore è valido solo se questa funzione restituisce zero e GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando questa funzione restituisce correttamente, la posizione di lettura nel registro eventi viene modificata in base al numero di record letti.

Nota Il nome file configurato per questa origine può anche essere il nome file configurato per altre origini (diverse origini possono esistere come sottochiave in un singolo log). Pertanto, questa funzione può restituire eventi registrati da più di un'origine.

Esempio

Per un esempio, vedere Query per informazioni sugli eventi.

Nota

L'intestazione winbase.h definisce ReadEventLog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll
Set di API	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introdotta in Windows 10, versione 10.0.10240)