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 | Скачать

JournalRecordProc

The JournalRecordProc hook procedure is a callback function that records messages the system removes from the system message queue. Later, an application can use a JournalPlaybackProc hook procedure to play back the messages.

LRESULT CALLBACK JournalRecordProc(

int code, // hook code
WPARAM wParam, // undefined
LPARAM lParam // address of message being processed
);

Parameters

code

Specifies how to process the message. This parameter can be one of the following values:

Value Meaning
HC_ACTION The lParam parameter points to an EVENTMSG structure containing information about a message removed from the system queue. The hook procedure must record the contents of the structure by copying them to a buffer or file.
HC_SYSMODALOFF A system-modal dialog box has been destroyed. The hook procedure must resume recording.
HC_SYSMODALON A system-modal dialog box is being displayed. Until the dialog box is destroyed, the hook procedure must stop recording.

If code is less than zero, the hook procedure must pass the message to the CallNextHookEx function without further processing and should return the value returned by CallNextHookEx.

wParam

Specifies a NULL value.

lParam

Points to an EVENTMSG structure that contains the message to be recorded.

Return Values

The return value is ignored.

Remarks

A JournalRecordProc hook procedure must copy but not modify the messages. After the hook procedure returns control to the system, the message continues to be processed.
An application installs a JournalRecordProc hook procedure by specifying the WH_JOURNALRECORD hook type and the address of the hook procedure in a call to the SetWindowsHookEx function.
A Win32 JournalRecordProc hook procedure does not need to live in a dynamic-link library. A Win32 JournalRecordProc hook procedure can live in the application itself.

Unlike most other global hook procedures, the JournalRecordProc and JournalPlaybackProc hook procedures are always called in the context of the thread that set the hook.
An application that has installed a JournalRecordProc hook procedure should watch for the VK_CANCEL virtual keycode (which is implemented as the CTRL+BREAK key combination on most keyboards). This virtual keycode should be interpreted by the application as a signal that the user wishes to stop journal recording. The application should respond by ending the recording sequence and removing the JournalRecordProc hook procedure. Removal is important. It prevents a journaling application from locking up the system by hanging inside a hook procedure.

This role as a signal to stop journal recording means that a CTRL+BREAK key combination cannot itself be recorded. Since the CTRL+C key combination has no such role as a journaling signal, it can be recorded. There are two other key combinations that cannot be recorded: CTRL+ESC and CTRL+ALT+DEL. Those two key combinations cause the system to stop all journaling activities (record or playback), remove all journaling hooks, and post a WM_CANCELJOURNAL message to the journaling application.

JournalRecordProc is a placeholder for an application-defined or library-defined function name.

See Also

CallNextHookEx, EVENTMSG, JournalPlaybackProc, SetWindowsHookEx, WM_CANCELJOURNAL

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

JournalRecordProc

Процедура захвата JournalRecordProc является функцией возврата, которая записывает сообщения, которые система удаляется из системной очереди сообщения. Позже, приложение может использовать процедуру захвата JournalPlaybackProc, чтобы играться сообщения.

LRESULT CALLBACK JournalRecordProc(

int код, // перехватывает код WPARAM wParam, // неопределенный адрес LPARAM lParam // сообщения, обрабатыванного
);

Параметры

код

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

Значение Величины
HC_ACTION параметр lParam указывает на структуру EVENTMSG, содержащую информацию о сообщении удаленном из системной очереди. Рычажная процедура должна записать содержание структуры копируя их в буфер или файл.
HC_SYSMODALOFF системный-модальный диалоговый блок уничтожен. Рычажная процедура должна итоговая запись.
HC_SYSMODALON системный-модальный диалоговый блок отображается. Пока диалоговый блок не будет уничтожен, рычажная процедура должна стоповая запись.

Если код - менее чем нуль, рычажная процедура должна передать сообщение в функцию CallNextHookEx без продвигать обрабатывая и должна возвращать величину возвращанную CallNextHookEx.

wParam

Определяет НЕДЕЙСТВИТЕЛЬНУЮ величину.

lParam

Точки на структуру EVENTMSG, которые содержат сообщение, которое нужно записываться.

Обратные Величины

Обратная величина проигнорирована.

Замечания

Процедура захвата JournalRecordProc должна скопировать но не модифицировать сообщения. После того, как рычажная процедура возвращает управление в систему, сообщение остается обработан.
Приложение устанавливает процедуру захвата JournalRecordProc определяя рычажный тип WH_JOURNALRECORD и адрес рычажной процедуры на вызове в функцию SetWindowsHookEx.
Процедуре захвата Win32 JournalRecordProc не нужно жить на динамической связи библиотеки. Процедура захвата Win32 JournalRecordProc может пожить в приложении себя.

В отличие от большинства других глобальных рычажных процедур, JournalRecordProc и процедуры захвата JournalPlaybackProc всегда приглашены контекст резьбы, которая устанавливает захват.
Приложение, которое установило процедуру захвата JournalRecordProc должно ожидать VK_CANCEL виртуальный keycode (который осуществлен как ключевая комбинация CTRL+BREAK на большинстве клавиатуре). Этот виртуальный keycode должно быть интерпретировано приложением как сигнализировать, что пользователь хочет останавливать запись журнала. Приложение должно отвечать заканчивая запись последовательности и удаляя процедуру захвата JournalRecordProc. Удаление важное. Это мешает приложение регистрации чтобы блокировать систему вися в рычажной процедуре.

Эта роль как сигнал, чтобы останавливать журнал, записывающий означает, что ключевая комбинация CTRL+BREAK не может сам записан. С тех пор как ключевая комбинация CTRL+C не имеет такую роль как сигнал регистрации, она может быть записана. Есть две других ключевых комбинации, которые не могут быть записаны: CTRL+ESC и CTRL+ALT+DEL. Те две ключевых комбинации заставляют систему, чтобы останавливать всю деятельность регистрации (запись или воспроизведение), удалять весь захват регистрации и посылать сообщение WM_CANCELJOURNAL в приложение регистрации.

JournalRecordProc - метка-заполнитель для определенный приложение или определивший библиотечное функциональное имя.

Смотри Также

CallNextHookEx, EVENTMSG, JournalPlaybackProc, SetWindowsHookEx, WM_CANCELJOURNAL

Используются технологии uCoz