WinQueryPointer
Appearance
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);