The OpenEventLog function opens a handle of an event log.
HANDLE OpenEventLog(
| LPCTSTR lpUNCServerName, | // pointer to server name |
| LPCTSTR lpSourceName | // pointer to source name |
| ); |
Parameters
lpUNCServerName
Points to a null-terminated string that specifies the Universal Naming Convention (UNC) name of the server on which the event log is to be opened. If this parameter is NULL, the log is opened on the local computer.
lpSourceName
Points to a null-terminated string that specifies the name of the source that the returned handle will reference. The source name must be a subkey of a logfile entry under the EventLog key in the registry. For example, the source name WinApp would be valid if the registry had the following form:
HKEY_LOCAL_MACHINE
System
CurrentControlSet
Services
EventLog
Application
WinApp
Security
System
If the source name cannot be found, the event logging service uses the Application logfile with no message files for the event identifier or category.
Return Values
If the function succeeds, the return value is the handle of an event log.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
See Also
ClearEventLog, CloseEventLog, GetNumberOfEventLogRecords, GetOldestEventLogRecord, ReadEventLog, ReportEvent