|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winbase.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RegisterEventSource
The RegisterEventSource function returns a handle that can be used with the ReportEvent function to log an event.
Any source name can be used; it will be carried in the event log record so
that Event Viewer can use it for filtering.
HANDLE RegisterEventSource(
LPCTSTR lpUNCServerName,
| // server name for source
| LPCTSTR lpSourceName
| // source name for registered handle
| );
|
|
Parameters
lpUNCServerName
Points to a null-terminated string that specifies the Universal Naming
Convention (UNC) name of the server on which this operation is to be performed. If
this parameter is NULL, the operation is performed on the local computer.
lpSourceName
Points to a null-terminated string that specifies the name of the source
referenced by the returned handle. 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 a handle that can be used with
the ReportEvent function.
If the function fails, the return value is NULL. To get extended error
information, call GetLastError.
See Also
DeregisterEventSource, ReportEvent
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
