Jump to content

WinQueryPointer

From EDM2
Revision as of 03:23, 9 April 2025 by Martini (talk | contribs) (Created page with "This function ''returns the pointer handle for hwndDeskTop''. ==Syntax== WinQueryPointer(hwndDeskTop) ==Parameters== ;hwndDeskTop (HWND) - Input : Desktop-window handle. :;HWND_DESKTOP :: The desktop-window handle :;Other :: Specified desktop-window handle. ==Returns== ;hptrPointer (HPOINTER) - returns : Pointer handle. :;NULLHANDLE :: Error occurred. ==Remarks== ''(No additional remarks were provided in the original text.)'' ==Errors== Possible returns fro...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This function returns the pointer handle for hwndDeskTop.

Syntax

WinQueryPointer(hwndDeskTop)

Parameters

hwndDeskTop (HWND) - Input
Desktop-window handle.
HWND_DESKTOP
The desktop-window handle
Other
Specified desktop-window handle.

Returns

hptrPointer (HPOINTER) - returns
Pointer handle.
NULLHANDLE
Error occurred.

Remarks

(No additional remarks were provided in the original text.)

Errors

Possible returns from WinGetLastError:

PMERR_INVALID_HWND (0x1001)
An invalid window handle was specified.

Example Code

#define INCL_WINPOINTERS /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HWND     hwndDeskTop;  /*  Desktop-window handle. */
HPOINTER hptrPointer;  /*  Pointer handle. */

hptrPointer = WinQueryPointer(hwndDeskTop);

This example obtains the pointer handle from the desktop window handle.

#define INCL_WINPOINTERS
#define INCL_WINDESKTOP
#include <OS2.H>

HAB      hab;
HPOINTER hpointer;

hpointer = WinQueryPointer(HWND_DESKTOP);

Related Functions