Type a page name and press Enter. You'll jump to the page if it exists, or you can create it if it doesn't.
To create a page in a module other than user32, prefix the name with the module name and a period.
<DllImport("user32.dll")> _
Public Shared Function SetWindowsHookEx( _
ByVal idHook As Integer, _
ByVal lpfn As HookProc, _
ByVal hMod As IntPtr, _
ByVal dwThreadId As Integer) As IntPtr
End Function
User-Defined Types:
A HookType constant specifying the type of hook to install.
A HookProc delegate representing the hook procedure method.
Notes:
This will enable you to install application hooks. However, you cannot implement global hooks in Microsoft .NET Framework. To install a global hook, a hook must have a native dynamic-link library (DLL) export to inject itself in another process that requires a valid, consistent function to call into. This requires a DLL export, which .NET Framework does not support. Managed code has no concept of a consistent value for a function pointer because these function pointers are proxies that are built dynamically.
Calling the CallNextHookEx function to chain to the next hook procedure is optional, but it is highly recommended; otherwise, other applications that have installed hooks will not receive hook notifications and may behave incorrectly as a result. You should call CallNextHookEx unless you absolutely need to prevent the notification from being seen by other applications.
Before terminating, an application must call the UnhookWindowsHookEx function to free system resources associated with the hook.
Tips & Tricks:
Remember to keep the HookProc delegate alive manually, otherwise the garbage collector will clean up your hook delegate eventually, resulting in your code throwing a System.NullReferenceException.
Sample Code:
// this sample installs a keyboard hook
using System.Windows.Forms;
public class MyClass
{
private HookProc myCallbackDelegate = null;
public MyClass()
{
// initialize our delegate
this.myCallbackDelegate = new HookProc(this.MyCallbackFunction);
// setup a keyboard hook
SetWindowsHookEx(HookType.WH_KEYBOARD, this.myCallbackDelegate, IntPtr.Zero, AppDomain.GetCurrentThreadId());
}
private void MyCallbackFunction(int code, IntPtr wParam, IntPtr lParam)
{
// we can convert the 2nd parameter (the key code) to a System.Windows.Forms.Keys enum constant
Keys keyPressed = (Keys)wParam.ToInt32();
Console.WriteLine(keyPressed);
}
}
VB Sample Code:
Private myCallbackDelegate As HookProc = Nothing
Public Sub main()
' initialize our delegate
myCallbackDelegate = New HookProc(AddressOf MyCallbackFunction)
' setup a keyboard hook
Dim hp As IntPtr = SetWindowsHookEx(HookType.WH_KEYBOARD, myCallbackDelegate, IntPtr.Zero, AppDomain.GetCurrentThreadId())
' Type into the form to test.
Dim tf As New Form
tf.ShowDialog()
' Close the form to continue
Console.WriteLine(UnhookWindowsHookEx(hp))
End Sub
Private Function MyCallbackFunction(ByVal code As Integer, ByVal wParam As IntPtr, ByVal lParam As IntPtr) As Integer
' we can convert the 2nd parameter (the key code) to a System.Windows.Forms.Keys enum constant
Dim keyPressed As Keys = CType(wParam.ToInt32(), Keys)
Console.WriteLine(keyPressed)
Return CallNextHookEx(Nothing, code, wParam, lParam)
End Function
Alternative Managed API:
Do you know one? Please contribute it!
Enumerates the valid hook types passed as the idHook parameter into a call to SetWindowsHookEx.
Represents the method called when a hook catches a monitored event.
6/24/2022 6:31:50 AM - Nicolas-93.20.31.10
The CallNextHookEx API
3/29/2016 1:15:57 PM - -65.216.74.168
The CallNextHookEx API
3/29/2016 1:15:57 PM - -65.216.74.168
The UnhookWindowsHookEx API
1/7/2019 10:40:51 AM - -93.41.3.12
Represents the method called when a hook catches a monitored event.
6/24/2022 6:31:50 AM - Nicolas-93.20.31.10
Please edit this page!
Do you have...
helpful tips or sample code to share for using this API in managed code?
corrections to the existing content?
variations of the signature you want to share?
additional languages you want to include?
Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).