EnableMouseInPointer function (winuser.h)

Enables the mouse to act as a pointer input device and send WM_POINTER messages.

Syntax

BOOL EnableMouseInPointer(
  [in] BOOL fEnable
);

Parameters

[in] fEnable

TRUE to turn on mouse input support in WM_POINTER.

Return value

If the function succeeds, the return value is non-zero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function can be called only once in the context of a process lifetime. Prior to the first call, Windows Store apps run with mouse-in-pointer enabled, as do any desktop applications that consume mshtml.dll. All other desktop applications run with mouse-in-pointer disabled.

On the first call in the process lifetime, the state is changed as specified and the call succeeds.

On subsequent calls, the state will not change. If the current state is not equal to the specified state, the call fails.

Call IsMouseInPointerEnabled to verify the mouse-in-pointer state.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See also

Functions

IsMouseInPointerEnabled

WM_POINTER