Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции GetEventLogInformation.
GetEventLogInformation
Функция GetEventLogInformation извлекает информацию об указанном журнале событий.
BOOL GetEventLogInformation(
HANDLE hEventLog, // дескриптор журнала событий
DWORD dwInfoLevel, // извлекаемая информация
LPVOID lpBuffer, // буфер для прочитанных данных
DWORD cbBufSize, // размер буфера в байтах
LPDWORD pcbBytesNeeded // необходимое количество байт
);
Параметры
hEventLog – дескриптор журнала событий. Этот дескриптор возвращается функциями
OpenEventLog или RegisterEventSource.
dwInfoLevel – уровень информации, которая должна быть извлечена. Используйте
структуру EVENTLOG_FULL_INFO для определения того, является ли заполненным указанный
журнал событий. Значение параметра lpBuffer представляет собой указатель на структуру
EVENTLOG_FULL_INFORMATION. В настоящее время другие уровни информации не определены.
lpBuffer – указатель на буфер для информации о журнале событий. Формат данных
зависит от значения параметра dwInfoLevel.
cbBufSize – размер буфера в байтах.
pcbBytesNeeded – указатель на переменную, получающую число байт, требуемых для
запрашиваемой информации, вне зависимости от того, завершился успехом вызов функции
или нет. Значение этого параметра не может быть равно NULL.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об
ошибке вызовите функцию GetLastError.
Требования
Windows NT/2000/XP: включена в Windows NT 3.1 и выше.
Windows 95/98/Me: не поддерживается.
Заголовок: объявлена в Winbase.h; подключатьWindows.h.
Библиотека: используйте Advapi32.lib.
Unicode: реализована как Unicode и ANSI версия.
См. также
EVENTLOG_FULL_INFORMATION, OpenEventLog, RegisterEventSource.
хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru