GetOldestEventLogRecord.md

Home

Function name : GetOldestEventLogRecord

Group: Event Logging - Library: advapi32

---

Retrieves the absolute record number of the oldest record in the specified event log.

---

Code examples:

Reading entries from Event logs

Declaration:

BOOL GetOldestEventLogRecord(
	HANDLE hEventLog,
	PDWORD OldestRecord
);  

---

FoxPro declaration:

DECLARE INTEGER GetOldestEventLogRecord IN advapi32;
	INTEGER hEventLog,;
	LONG @OldestRecord  

---

Parameters:

hEventLog [in] A handle to the open event log. This handle is returned by the OpenEventLog or OpenBackupEventLog function.

OldestRecord [out] A pointer to a variable that receives the absolute record number of the oldest record in the specified event log.

---

Return value:

If the function succeeds, the return value is nonzero.

---

Comments:

The oldest record in an event log is not necessarily record number 1.

hLog = OpenEventLog(NULL, "Application")  
  
IF hLog <> 0  
	STORE 0 TO nReccount, nRecno  
  
	= GetNumberOfEventLogRecords(m.hLog, @nReccount)  
	= GetOldestEventLogRecord(m.hLog, @nRecno)  
  
	? nReccount, nRecno  
  
	= CloseEventLog(hLog)  
ENDIF

---