Dela via


Funktionen GetMsgProc

Description

En programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen SetWindowsHookExA/SetWindowsHookExW . Systemet anropar den här funktionen när funktionen GetMessage eller PeekMessageA/PeekMessageW har hämtat ett meddelande från en programmeddelandekö. Innan det hämtade meddelandet returneras till anroparen skickar systemet meddelandet till krokproceduren.

TYPEN HOOKPROC definierar en pekare för den här återanropsfunktionen. GetMsgProc är en platshållare för det programdefinierade eller biblioteksdefinierade funktionsnamnet.

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

Parameterar

kod [in]

Typ: int

Anger om hook-proceduren måste bearbeta meddelandet. Om kodenär HC_ACTION måste hook-proceduren bearbeta meddelandet. Om koden är mindre än noll måste hook-proceduren skicka meddelandet till funktionen CallNextHookEx utan vidare bearbetning och returnera det värde som returneras av CallNextHookEx.

wParam [in]

Typ: WPARAM

Anger om meddelandet har tagits bort från kön. Den här parametern kan vara ett av följande värden.

Värde Innebörd
PM_NOREMOVE 0x0000 Meddelandet har inte tagits bort från kön. (Ett program som kallas funktionen PeekMessage och som anger flaggan PM_NOREMOVE .)
PM_REMOVE 0x0001 Meddelandet har tagits bort från kön. (Ett program som heter GetMessage eller kallas funktionen PeekMessage och anger flaggan PM_REMOVE .)

lParam [in]

Typ: LPARAM

En pekare till en MSG-struktur som innehåller information om meddelandet.

Retur

Om koden är mindre än noll måste krokproceduren returnera värdet som returneras av CallNextHookEx.

Om koden är större än eller lika med noll rekommenderar vi starkt att du anropar CallNextHookEx och returnerar det värde som returneras. I annat fall får andra program som har installerat WH_GETMESSAGE hooks inte hook-meddelanden och kan bete sig felaktigt som ett resultat. Om krokproceduren inte anropar CallNextHookEx ska returvärdet vara noll.

Anmärkningar

GetMsgProc-hookproceduren kan undersöka eller ändra meddelandet.

När hook-proceduren returnerar kontrollen till systemet returnerar funktionen GetMessage eller PeekMessageA/PeekMessageW meddelandet, tillsammans med eventuella ändringar, till programmet som ursprungligen kallade det.

Ett program installerar den här krokproceduren genom att ange WH_GETMESSAGE hook-typ och en pekare till krokproceduren i ett anrop till funktionen SetWindowsHookExA/SetWindowsHookExW .

Se även

CallNextHookEx

GetMessage

MSG

PeekMessage

AngeWindowsHookEx

Hookar