Search
Module:
Directory

   Desktop Functions:

   Smart Device Functions:


Show Recent Changes
Subscribe (RSS)
Misc. Pages
Comments
FAQ
Helpful Tools
Playground
Suggested Reading
Website TODO List
Download Visual Studio Add-In

SetWindowsHookEx (user32)
 
.
Summary
Installs a hook to monitor certain types of events.

C# Signature:

[DllImport("user32.dll")]
static extern IntPtr SetWindowsHookEx(HookType hook, HookProc callback,
   IntPtr hMod, uint dwThreadId);

VB Signature:

<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());
     }

     [DllImport("user32.dll")]
     protected static extern IntPtr SetWindowsHookEx(HookType code, HookProc func, IntPtr hInstance, int threadID);

     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.ToString())
    Return CallNextHookEx(Nothing, code, wParam, lParam)
End Function

Alternative Managed API:

Do you know one? Please contribute it!

Documentation
Example
Article

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).

 
Access PInvoke.net directly from VS:
Terms of Use
Find References
Show Printable Version
Revisions