Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Description
Funkce zpětného volání definovaná aplikací nebo knihovnami používaná s funkcí SetWindowsHookExA/SetWindowsHookExW . Systém tuto funkci volá pokaždé, když funkce GetMessage nebo PeekMessageA/PeekMessageW načetla zprávu z fronty zpráv aplikace. Před vrácením načtené zprávy volajícímu systém předá zprávu do procedury háku.
Typ HOOKPROC definuje ukazatel na tuto funkci zpětného volání. GetMsgProc je zástupný symbol pro název funkce definované aplikací nebo knihovny.
LRESULT CALLBACK GetMsgProc(
_In_ int code,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
Parametry
code [in]
Typ: int
Určuje, jestli procedura háku musí zpracovat zprávu. Pokud je kódHC_ACTION, musí procedura háku zpracovat zprávu. Pokud je kód menší než nula, musí procedura hook předat zprávu funkci CallNextHookEx bez dalšího zpracování a měla by vrátit hodnotu vrácenou CallNextHookEx.
wParam [in]
Typ: WPARAM
Určuje, jestli byla zpráva odebrána z fronty. Tento parametr může být jednou z následujících hodnot.
| Hodnota | Význam |
|---|---|
| PM_NOREMOVE 0x0000 | Zpráva nebyla odebrána z fronty. (Aplikace volala funkci PeekMessage , která určuje příznak PM_NOREMOVE .) |
| PM_REMOVE 0x0001 | Zpráva byla odebrána z fronty. (Aplikace s názvem GetMessage nebo se nazývá Funkce PeekMessage , která určuje příznak PM_REMOVE .) |
lParam [in]
Typ: LPARAM
Ukazatel na strukturu MSG , která obsahuje podrobnosti o zprávě.
Návraty
Pokud je kód menší než nula, musí procedura hook vrátit hodnotu vrácenou CallNextHookEx.
Pokud je kód větší nebo roven nule, důrazně doporučujeme volat CallNextHookEx a vrátit hodnotu, kterou vrátí; jinak ostatní aplikace, které mají nainstalované WH_GETMESSAGE háky, nebudou dostávat oznámení o háku a mohou se chovat nesprávně jako výsledek. Pokud procedura hook nevolá CallNextHookEx, návratová hodnota by měla být nula.
Poznámky
Procedura getMsgProc hook může zprávu prozkoumat nebo upravit.
Jakmile procedura hook vrátí řízení do systému, GetMessage neboPeekMessageA/PeekMessageW funkce vrátí zprávu spolu s případnými úpravami aplikace, která ji původně volala.
Aplikace tuto proceduru háku nainstaluje zadáním typu WH_GETMESSAGE háku a ukazatelem na proceduru háku ve volání funkce SetWindowsHookExA/SetWindowsHookExW.