EnableMouseInPointer function

Enables the mouse to act as a pointing device.

Syntax


 WINAPI EnableMouseInPointer(
  _In_  BOOL fEnable
);

Parameters

fEnable [in]

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Functions
IsMouseInPointerEnabled

 

 

Community Additions

ADD
Show:
© 2014 Microsoft