На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

EVENTLOGRECORD



The EVENTLOGRECORD structure contains information about an event record.

typedef struct _EVENTLOGRECORD { // evlr
DWORD Length;
DWORD Reserved;
DWORD RecordNumber;
DWORD TimeGenerated;
DWORD TimeWritten;
DWORD EventID;
WORD EventType;
WORD NumStrings;
WORD EventCategory;
WORD ReservedFlags;
DWORD ClosingRecordNumber;
DWORD StringOffset;
DWORD UserSidLength;
DWORD UserSidOffset;
DWORD DataLength;
DWORD DataOffset;
//
// Then follow:

//
// TCHAR SourceName[]
// TCHAR Computername[]
// SID UserSid
// TCHAR Strings[]
// BYTE Data[]
// CHAR Pad[]
// DWORD Length;
//
} EVENTLOGRECORD;


Members

Length

Specifies the length, in bytes, of this event record. Note that this value is stored at both ends of the entry to ease moving forward or backward through the log. The length includes any pad bytes inserted at the end of the record for DWORD alignment.

Reserved

Reserved.

RecordNumber

Contains a record number that can be used with the EVENTLOG_SEEK_READ flag passed in a call to the ReadEventLog function to begin reading at a specified record.

TimeGenerated

The time at which this entry was submitted. This time is measured in the number of seconds elapsed since 00:00:00 January 1, 1970.

TimeWritten

Specifies the time at which this entry was received by the service to be written to the logfile. This time is measured in the number of seconds elapsed since 00:00:00 January 1, 1970.

EventID

Identifies the event. This is specific to the source that generated the event log entry, and is used, together with SourceName, to identify a message in a message file that is presented to the user while viewing the log.

EventType

Specifies the type of event. This member can be one of the following values:

Value Meaning
EVENTLOG_ERROR_TYPE Error event
EVENTLOG_WARNING_TYPE Warning event
EVENTLOG_INFORMATION_TYPE Information event
EVENTLOG_AUDIT_SUCCESS Success Audit event
EVENTLOG_AUDIT_FAILURE Failure Audit event


For more information about event types, see Event Logging.

NumStrings

Specifies the number of strings present in the log (at the position indicated by StringOffset). These strings are merged into the message before it is displayed to the user.

EventCategory

Specifies a subcategory for this event. This subcategory is source specific.

ReservedFlags

Reserved.

ClosingRecordNumber

Reserved.

StringOffset

Specifies the offset of the strings within this event log entry.

UserSidLength

Specifies the length, in bytes, of the UserSid member. This value can be zero if no security identifier was provided.

UserSidOffset

Specifies the offset of the security identifier within this event record.

DataLength

Specifies the length, in bytes, of the event-specific data (at the position indicated by DataOffset).

DataOffset

Specifies the offset of the event-specific information within this log. This information could be something specific (a disk driver might log the number of retries, for example), followed by binary information specific to the event being logged and to the source that generated the entry.

SourceName

Contains the variable-length null-terminated string specifying the name of the source (application, service, driver, subsystem) that generated the entry. This is the name used to retrieve from the registry the name of the file containing the message strings for this source. It is used, together with the event identifier, to get the message string that describes this event.

Computername

Contains the variable-length null-terminated string specifying the name of the computer that generated this event. There may also be some pad bytes after this field to ensure that the UserSid is aligned on a DWORD boundary.

UserSid

Specifies the security identifier of the active user at the time this event was logged. This member may be empty if the UserSidLength member is zero.



The defined members are followed by the replacement strings for the message identified by the event identifier, the binary information, some pad bytes to make sure the full entry is on a DWORD boundary, and finally the length of the log entry again. Because the strings and the binary information can be of any length, no structure members are defined to reference them.
The event identifier together with SourceName and a language identifier identify a message string that describes the event in more detail. The strings are used as replacement strings and are merged into the message string to make a complete message. The message strings are contained in a message file specified in the source entry in the registry.

The binary information is information that is specific to the event. It could be the contents of the processor registers when a device driver got an error, a dump of an invalid packet that was received from the network, a dump of all the structures in a program (when the data area was detected to be corrupt), and so on. This information should be useful to the writer of the device driver or the application in tracking down bugs or unauthorized breaks into the application.

See Also

ReadEventLog


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

EVENTLOGRECORD



Структура EVENTLOGRECORD содержит информацию о записи события.

typedef struct _EVENTLOGRECORD { // evlr Длина DWORD;
DWORD ЗАРЕЗЕРВИРОВАН;
DWORD RecordNumber;
DWORD TimeGenerated;
DWORD TimeWritten;
DWORD EventID;
СЛОВО EventType;
СЛОВО NumStrings;
СЛОВО EventCategory;
СЛОВО ReservedFlags;
DWORD ClosingRecordNumber;
DWORD StringOffset;
DWORD UserSidLength;
DWORD UserSidOffset;
DWORD DataLength;
DWORD DataOffset;
//
// Затем последуйте за:

//
// TCHAR SourceName[] // TCHAR Computername[] // СТРОКИ SID UserSid // TCHAR[] // БАЙТОВЫЕ Данные[] // СИМВОЛЬНАЯ Панель[] // Длина DWORD;
//
} EVENTLOGRECORD;


Участники

Длина

Определяет длину, в байтах, этой записи события. Отметьте, что эта величина загружена в обоих концах входа, чтобы снижать перемещение форварда или назад через протокол. Длина включает любые байты панели включенные в конце записи для выравнивания DWORD.

Зарезервированное

Зарезервированное.

RecordNumber

Содержит рекордный номер, который может быть использован флагом EVENTLOG_SEEK_READ пройденным на вызов в функцию ReadEventLog, чтобы начинать читаться в определенной записи.

TimeGenerated

Время в котором этот вход был подан. На этот раз измерен в ряде секунд пройденных с 00:00:00 1 Января, 1970.

TimeWritten

Определяет время в котором этот вход был получен услугой, которая нужно записывать в logfile. На этот раз измерен в ряде секунд пройденных с 00:00:00 1 Января, 1970.

EventID

Идентифицирует событие. Это характерное для источника, который генерировал регистрационный вход события и использован, вместе с SourceName, чтобы идентифицировать сообщение в файле сообщения, который представлен пользователю при просмотре протокола.

EventType

Определяет тип события. Этот элемент может быть одним из следующего величин:

Значение Величины
событие Ошибки EVENTLOG_ERROR_TYPE EVENTLOG_WARNING_TYPE, предупреждающее событие Информации события Проверки Успеха Проверки Неудачи события события EVENTLOG_INFORMATION_TYPE EVENTLOG_AUDIT_SUCCESS EVENTLOG_AUDIT_FAILURE


Более подробно о типах события, смотри Регистрацию События.

NumStrings

Определяет количество настоящего строк в протоколе (в позиции указанной StringOffset). Эти строки объединены в сообщение прежде, чем она будет отображена пользователю.

EventCategory

Определяет подкатегорию для этого события. Эта подкатегория исходная специфическая.

ReservedFlags

Зарезервированное.

ClosingRecordNumber

Зарезервированное.

StringOffset

Определяет смещение строк в пределах этого регистрационного входа события.

UserSidLength

Определяет длину, в байтах, элемента UserSid. Эта величина может быть нулем если никакой идентификатор безопасности не был предусмотрен.

UserSidOffset

Определяет смещение идентификатора безопасности в пределах этой записи события.

DataLength

Определяет длину, в байтах, событие-специфических данных (в позиции указанной DataOffset).

DataOffset

Определяет смещение событие-специфической информации в пределах этого протокола. Эта информация могла быть что-то специфической ( дисковый драйвер мог зарегистрировать количество повторных попыток, например), сопровожденное двоичным информационным специфическим в событие, регистрированное и в источник, который генерировал вход.

SourceName

Содержит переменную-длину недействительный расторгнутая строка определяя имя источника (приложение, услуга, драйвер, подсистема), что генерировал вход. Это - имя использованное, чтобы извлекаться из регистрации имя файла, содержащего строки сообщения для этого источника. Использовано, вместе с идентификатором события, чтобы получать строку сообщения, которая описывает это событие.

Computername

Содержит переменную-длину недействительный расторгнутая строка определяя имя компьютера, который генерировал это событие. Может также быть некоторыми байтами панели после этой области, чтобы проверять, что UserSid выровнен на границе DWORD.

UserSid

Определяет идентификатор безопасности активного пользователя, что в то время это событие было зарегистрировано. Этот элемент может быть пустым если элемент UserSidLength нулевой.



Определенные участники следуют за строками замены для сообщения идентифицированного идентификатором события, двоичная информация, некоторые заполняют байты, чтобы убеждаться что полный вход находится на границе DWORD, и наконец длина регистрационного входа снова. Поскольку строки и двоичная информация могут быть любой длины, никакие структурные участники не определены, чтобы ссылаться на них.
Идентификатор события вместе с SourceName и языковым идентификатором идентифицирует строку сообщения, которая описывает событие более подробно. Строки использованы как строки замены и объединены в строку сообщения, чтобы делать полным сообщением. Строки сообщения содержались в файле сообщения определенном на исходном входе в регистрации.

Двоичная информация является информацией, которая характерная для события. Это могло быть содержанием регистров процессора когда драйвер устройства получал ошибку, дамп неправильного пакета, которые были получены из сети, дамп всех структур в программе (когда область данных была обнаружена, чтобы быть испорченым), и так далее. Эта информация должна быть полезной автору драйвера устройства или приложение в прослеживающих дефектах или несанкционированных прерываниях в приложение.

Смотри Также

ReadEventLog


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz