WinShowPointer

WinShowPointer(desktopHndl, flagShow): Show or hide the pointer.

Parameters

desktopHndl - HWND - input: HWND_DESKTOP or any other value - the desktop handle.
flagShow - BOOL - input

TRUE - decrement the hide count.
FALSE - increment the hide count.

Returns

Returns BOOL:

TRUE Successful
FALSE Unsuccessful

WinGetLastError possible returns:

PMERR_INVALID_HWND

Define (C/C++)

INCL_WINPOINTERS or INCL_PM or INCL_WIN

Calling Convention

Cdecl32

Example Code

HWND desktopHndl;
BOOL flagShow;
BOOL rc;
...
rc = WinShowPointer(desktopHndl, flagShow);
...

Related Functions

WinCreatePointer
WinCreatePointerIndirect
WinDestroyPointer
WinDrawPointer
WinLoadPointer
WinQueryPointer
WinQueryPointerInfo
WinQueryPointerPos
WinQuerySysPointer
WinQuerySysPointerData
WinSetPointer
WinSetPointerPos
WinSetSysPointerData

Notes

The pointer display level dictates the display of the pointer. The hide count needs to be zero for the pointer to display. At boot, if a pointing device exists, the pointer display level is set to zero; if a pointing device isn't detected, the pointer display level is set to one. To get the value of the pointing device call the WinQuerySysValue specifying the SV_POINTERLEVEL option.