GetMsgProc függvény

Description

A SetWindowsHookExA/SetWindowsHookExW függvényhez használt alkalmazás által definiált vagy kódtár által definiált visszahívási függvény. A rendszer akkor hívja meg ezt a függvényt, ha a GetMessage vagy a PeekMessageA/PeekMessageW függvény lekért egy üzenetet egy alkalmazás üzenetsorából. Mielőtt visszaküldené a lekért üzenetet a hívónak, a rendszer átadja az üzenetet a horog eljárásnak.

A HOOKPROC típus a visszahívási függvény mutatóját határozza meg. A GetMsgProc az alkalmazás által definiált vagy tár által definiált függvénynév helyőrzője.

LRESULT CALLBACK GetMsgProc(
  _In_ int    code,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Paraméterek

kód [in]

Típus: int

Megadja, hogy a horog eljárásnak feldolgoznia kell-e az üzenetet. Ha a kódHC_ACTION, a horog eljárásnak fel kell dolgoznia az üzenetet. Ha a kód nullánál kisebb, a horog eljárásnak további feldolgozás nélkül kell átadnia az üzenetet a CallNextHookEx függvénynek, és a CallNextHookEx által visszaadott értéket kell visszaadnia.

wParam [in]

Típus: WPARAM

Megadja, hogy az üzenet el lett-e távolítva az üzenetsorból. Ez a paraméter az alábbi értékek egyike lehet.

Érték Meaning
PM_NOREMOVE 0x0000 Az üzenet nem lett eltávolítva az üzenetsorból. (Egy PeekMessage függvény nevű alkalmazás, amely megadja a PM_NOREMOVE jelzőt.)
PM_REMOVE 0x0001 Az üzenet el lett távolítva az üzenetsorból. (Egy GetMessage nevű alkalmazás, vagy a PeekMessage függvény, amely megadja a PM_REMOVE jelzőt.)

lParam [in]

Típus: LPARAM

Az üzenet részleteit tartalmazó MSG-struktúra mutatója.

Visszatérítések

Ha a kód nullánál kisebb, a horog eljárásnak a CallNextHookEx által visszaadott értéket kell visszaadnia.

Ha a kód nagyobb vagy egyenlő nullánál, javasoljuk, hogy hívja meg a CallNextHookEx-et , és adja vissza a visszaadott értéket; ellenkező esetben a WH_GETMESSAGE horgokat telepített egyéb alkalmazások nem kapják meg a horogértesítéseket, és ennek következtében helytelenül viselkedhetnek. Ha a horog eljárás nem hívja meg a CallNextHookEx függvényt, a visszatérési értéknek nullának kell lennie.

Megjegyzések

A GetMsgProc hook eljárás megvizsgálhatja vagy módosíthatja az üzenetet.

Miután a horog eljárás visszaadja az irányítást a rendszernek, a GetMessage vagy a PeekMessageA/PeekMessageW függvény visszaadja az üzenetet, az esetleges módosításokkal együtt az eredetileg azt nevező alkalmazásnak.

Egy alkalmazás úgy telepíti ezt a horog eljárást, hogy megadja a WH_GETMESSAGE horogtípust és egy mutatót a horog eljárásához a SetWindowsHookExA/SetWindowsHookExW függvény hívásában.

Lásd még

CallNextHookEx

GetMessage

MSG

PeekMessage

SetWindowsHookEx

Hookok