eventlog

Documentation

Overview

Package eventlog implements access to Windows event log.

Index

• Constants
• func Install(src, msgFile string, useExpandKey bool, eventsSupported uint32) error
• func InstallAsEventCreate(src string, eventsSupported uint32) error
• func Remove(src string) error
• type Log
  • func Open(source string) (*Log, error)
  • func OpenRemote(host, source string) (*Log, error)
  • func (l *Log) Close() error
  • func (l *Log) Error(eid uint32, msg string) error
  • func (l *Log) Info(eid uint32, msg string) error
  • func (l *Log) Warning(eid uint32, msg string) error

Constants

const (
	// Log levels.
	Info    = windows.EVENTLOG_INFORMATION_TYPE
	Warning = windows.EVENTLOG_WARNING_TYPE
	Error   = windows.EVENTLOG_ERROR_TYPE
)

Functions

func Install

func Install(src, msgFile string, useExpandKey bool, eventsSupported uint32) error

Install modifies PC registry to allow logging with an event source src. It adds all required keys and values to the event log registry key. Install uses msgFile as the event message file. If useExpandKey is true, the event message file is installed as REG_EXPAND_SZ value, otherwise as REG_SZ. Use bitwise of log.Error, log.Warning and log.Info to specify events supported by the new event source.

func InstallAsEventCreate

func InstallAsEventCreate(src string, eventsSupported uint32) error

InstallAsEventCreate is the same as Install, but uses %SystemRoot%\System32\EventCreate.exe as the event message file.

func Remove

func Remove(src string) error

Remove deletes all registry elements installed by the correspondent Install.

Types

type Log

type Log struct {
	Handle windows.Handle
}

Log provides access to the system log.

func Open

func Open(source string) (*Log, error)

Open retrieves a handle to the specified event log.

func OpenRemote

func OpenRemote(host, source string) (*Log, error)

OpenRemote does the same as Open, but on different computer host.

func (*Log) Close

func (l *Log) Close() error

Close closes event log l.

func (*Log) Error

func (l *Log) Error(eid uint32, msg string) error

Error writes an error event msg with event id eid to the end of event log l. When EventCreate.exe is used, eid must be between 1 and 1000.

func (*Log) Info

func (l *Log) Info(eid uint32, msg string) error

Info writes an information event msg with event id eid to the end of event log l. When EventCreate.exe is used, eid must be between 1 and 1000.

func (*Log) Warning

func (l *Log) Warning(eid uint32, msg string) error

Warning writes an warning event msg with event id eid to the end of event log l. When EventCreate.exe is used, eid must be between 1 and 1000.