C# WPF user32.dll 을 이용하여 전역 키 후킹하기, 핫키 등록하기 / 키 보내기 (1) API와 상수보기

윈도우 프로그래밍에 갑작스레 관심이 높아진 이후로 C# 을 통해 이것 저것 만들다보니, 매크로나 유틸리티를 만드는데 거의 필수로 사용되는 기능임에도 정리가 잘된 곳이 없어 고생하며(삽질) 습득한 지식을 정리해본다. 

물론 남이 보기엔 허섭하겠지만...

1편: API와 상수보기 (지금 페이지)

2편: API와 상수등을 이용한 키 후킹하기 / 보내기 예제

1. user32.dll 살펴보기

 윈도우 OS에서 사용하는 사용자 인터페이스 API입니다.

 user32.dll 은 그래픽 장치 인터페이스(GDI)을 통해 입력장치(키보드/마우스 등)의 데이터를 프로그램이나 장치에 전송합니다.

 즉, 키보드 / 마우스 후킹에 있어서 윈도우 OS에서 가장 중요한 라이브러리죠.

 그렇기 때문에 아래와 같은 API 를 제공하고 있습니다.

2. API 보기

2.1. 데이터를 후킹할때 사용하는 API

[DllImport("user32.dll")]

public static extern IntPtr SetWindowsHookEx(int idHook, LowLevelKeyboardProc callback, IntPtr hInstance, uint threadId);

// 내 프로그램에서 후킹을 시작할 때 사용

[DllImport("user32.dll")]

public static extern bool UnhookWindowsHookEx(IntPtr hInstance);

// 내 프로그램에서 후킹을 해제할 때 사용

[DllImport("user32.dll")]

public static extern IntPtr CallNextHookEx(IntPtr idHook, int nCode, int wParam, IntPtr lParam);

// 키 입력이 일어난 원 프로그램에 값을 전달

[DllImport("kernel32.dll")]

public static extern IntPtr LoadLibrary(string lpFileName);

// user32 호출하기 위해 사용

[DllImport("user32.dll")]

public static extern ushort GetAsyncKeyState(Int32 vKey);

// 같이 눌린 키를 확인할 때 사용. 복합키 (CTRL + A 같은) 일때 사용.

// C# Keyboard.GetKeyStates 로 대체 가능합니다.

// 전역변수

private static LowLevelKeyboardProc _proc = HookProc;

private static IntPtr hhook = IntPtr.Zero;

2.2. 프로그램(또는 프로세스)에 임의의 입력값을 보낼 때 사용하는 API

[DllImport("user32.dll", EntryPoint = "FindWindowEx")]

public static extern IntPtr FindWindowEx(IntPtr hwndParent, IntPtr hwndChildAfter, string lpszClass, string lpszWindow);

// 프로그램(또는 프로세스)의 핸들러값을 찾는다.

[DllImport("user32.dll", CharSet = CharSet.Auto)]

private static extern int SendMessage(IntPtr hWnd, int msg, int wParam, IntPtr lParam);

// 프로그램(또는 프로세스)에 내가 원하는 값을 바로 보낸다.

[DllImport("user32.dll", CharSet = CharSet.Auto)] // used for button-down & button-up

private static extern int PostMessage(IntPtr hWnd, int msg, int wParam, IntPtr lParam);

// 프로그램(또는 프로세스)에 내가 원하는 값을 윈도우 메시지큐에 쌓는다. 큐에 쌓인 값은 순차적으로 나가게 된다.

[DllImport("user32.dll", CharSet = CharSet.Auto)]

private static extern bool SetForegroundWindow(IntPtr hWnd);

// 프로그램을 활성화 시킨다. 

2.3. API 관련 상수

API에서 사용하는 상수값은 아래와 같습니다.

const int VK_PROCESSKEY = 0xE5;

const int WM_IME_COMPOSITION = 0x10F;

const int WM_IME_ENDCOMPOSITION = 0x10E;

const int KEYEVENTF_EXTENDEDKEY = 0x1;

const int KEYEVENTF_KEYUP = 0x2;

const int WH_KEYBOARD_LL = 13;

const int WM_KEYDOWN = 0x100;

const int WM_KEYUP = 0x101;

const int WM_CHAR = 0x105;

const int WM_IME_STARTCOMPOSITION = 0x010D;

const int WM_LBUTTONDOWN = 0x0201;

const int WM_LBUTTONUP = 0x0202;

const int WM_LBUTTONDBLCLK = 0x0203;

const int WM_RBUTTONDOWN = 0x0204;

const int WM_RBUTTONUP = 0x0205;

const int WM_RBUTTONDBLCLK = 0x0206;

const int WM_MOUSEMOVE = 0x0200;

#region VirtualKey

public enum VKeys : int

{

    VK_LBUTTON = 0x01,  //Left mouse button

    VK_RBUTTON = 0x02,  //Right mouse button

    VK_CANCEL = 0x03,  //Control-break processing

    VK_MBUTTON = 0x04,  //Middle mouse button (three-button mouse)

    VK_BACK = 0x08,  //BACKSPACE key

    VK_TAB = 0x09,  //TAB key

    VK_CLEAR = 0x0C,  //CLEAR key

    VK_RETURN = 0x0D,  //ENTER key

    VK_SHIFT = 0x10,  //SHIFT key

    VK_CONTROL = 0x11,  //CTRL key

    VK_ALT = 0x12,  //ALT key

    VK_PAUSE = 0x13,  //PAUSE key

    VK_CAPITAL = 0x14,  //CAPS LOCK key

    VK_HANGUL = 0x15,

    VK_ESCAPE = 0x1B,  //ESC key

    VK_SPACE = 0x20,  //SPACEBAR

    VK_PAGE_UP = 0x21,  //PAGE UP key

    VK_PAGE_DOWN = 0x22,  //PAGE DOWN key

    VK_END = 0x23,  //END key

    VK_HOME = 0x24,  //HOME key

    VK_LEFT = 0x25,  //LEFT ARROW key

    VK_UP = 0x26,  //UP ARROW key

    VK_RIGHT = 0x27,  //RIGHT ARROW key

    VK_DOWN = 0x28,  //DOWN ARROW key

    VK_SELECT = 0x29,  //SELECT key

    VK_PRINT = 0x2A,  //PRINT key

    VK_EXECUTE = 0x2B,  //EXECUTE key

    VK_SNAPSHOT = 0x2C,  //PRINT SCREEN key

    VK_INSERT = 0x2D,  //INS key

    VK_DELETE = 0x2E,  //DEL key

    VK_HELP = 0x2F,  //HELP key

    VK_0 = 0x30,  //0 key

    VK_1 = 0x31,  //1 key

    VK_2 = 0x32,  //2 key

    VK_3 = 0x33,  //3 key

    VK_4 = 0x34,  //4 key

    VK_5 = 0x35,  //5 key

    VK_6 = 0x36,  //6 key

    VK_7 = 0x37,  //7 key

    VK_8 = 0x38,  //8 key

    VK_9 = 0x39,  //9 key

    VK_A = 0x41,  //A key

    VK_B = 0x42,  //B key

    VK_C = 0x43,  //C key

    VK_D = 0x44,  //D key

    VK_E = 0x45,  //E key

    VK_F = 0x46,  //F key

    VK_G = 0x47,  //G key

    VK_H = 0x48,  //H key

    VK_I = 0x49,  //I key

    VK_J = 0x4A,  //J key

    VK_K = 0x4B,  //K key

    VK_L = 0x4C,  //L key

    VK_M = 0x4D,  //M key

    VK_N = 0x4E,  //N key

    VK_O = 0x4F,  //O key

    VK_P = 0x50,  //P key

    VK_Q = 0x51,  //Q key

    VK_R = 0x52,  //R key

    VK_S = 0x53,  //S key

    VK_T = 0x54,  //T key

    VK_U = 0x55,  //U key

    VK_V = 0x56,  //V key

    VK_W = 0x57,  //W key

    VK_X = 0x58,  //X key

    VK_Y = 0x59,  //Y key

    VK_Z = 0x5A,  //Z key

    VK_NUMPAD0 = 0x60,  //Numeric keypad 0 key

    VK_NUMPAD1 = 0x61,  //Numeric keypad 1 key

    VK_NUMPAD2 = 0x62,  //Numeric keypad 2 key

    VK_NUMPAD3 = 0x63,  //Numeric keypad 3 key

    VK_NUMPAD4 = 0x64,  //Numeric keypad 4 key

    VK_NUMPAD5 = 0x65,  //Numeric keypad 5 key

    VK_NUMPAD6 = 0x66,  //Numeric keypad 6 key

    VK_NUMPAD7 = 0x67,  //Numeric keypad 7 key

    VK_NUMPAD8 = 0x68,  //Numeric keypad 8 key

    VK_NUMPAD9 = 0x69,  //Numeric keypad 9 key

    VK_SEPARATOR = 0x6C,  //Separator key

    VK_SUBTRACT = 0x6D,  //Subtract key

    VK_DECIMAL = 0x6E,  //Decimal key

    VK_DIVIDE = 0x6F,  //Divide key

    VK_F1 = 0x70,  //F1 key

    VK_F2 = 0x71,  //F2 key

    VK_F3 = 0x72,  //F3 key

    VK_F4 = 0x73,  //F4 key

    VK_F5 = 0x74,  //F5 key

    VK_F6 = 0x75,  //F6 key

    VK_F7 = 0x76,  //F7 key

    VK_F8 = 0x77,  //F8 key

    VK_F9 = 0x78,  //F9 key

    VK_F10 = 0x79,  //F10 key

    VK_F11 = 0x7A,  //F11 key

    VK_F12 = 0x7B,  //F12 key

    VK_SCROLL = 0x91,  //SCROLL LOCK key

    VK_LSHIFT = 0xA0,  //Left SHIFT key

    VK_RSHIFT = 0xA1,  //Right SHIFT key

    VK_LCONTROL = 0xA2,  //Left CONTROL key

    VK_RCONTROL = 0xA3,  //Right CONTROL key

    VK_LALT = 0xA4,   //Left ALT key

    VK_RALT = 0xA5,  //Right ALT key

    VK_PLAY = 0xFA,  //Play key

    VK_ZOOM = 0xFB, //Zoom key

};

#endregion

4. 주의할 점

`SendMassage` 혹은 `PostMessage` API는 거의 동일하게 동작하며, 실행시간도 크게 다르지 않다.

따라서 둘 중 무엇을 써도 상관은 없으나, `SendMessage`는 반환에 있어 `예상치 못한 익셉션`으로 인해 시스템이 죽어버릴 수도 있다고 합니다. (발췌)

다음편에서는 실제 사용예제를 보겠습니다.