View source for WinQueryCapture

This function returns the handle of the window that has the pointer captured.

==Syntax==
 WinQueryCapture(hwndDesktop)

==Parameters==
;hwndDesktop ([[HWND]]) - Input: Desktop-window handle.
:HWND_DESKTOP: The desktop-window handle.
:Other: Specified desktop-window handle.

==Returns==
;hwnd (HWND) - Returns: Handle of the window with the pointer captured.
:;NULLHANDLE: No window has the pointer captured, or an error occurred.
:;Handle: Handle of the window with the pointer captured.

==Errors==
Possible returns from [[WinGetLastError]]:
; PMERR_INVALID_HWND (0x1001) :An invalid window handle was specified.

==Example Code==
<PRE>
#define INCL_WININPUT /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HWND     hwndDesktop; /* Desktop-window handle. */
HWND     hwnd;        /* Handle of the window with the pointer captured. */

hwnd = WinQueryCapture(hwndDesktop);
</PRE>
This function returns the handle of the window that has the pointer captured.
<PRE>
#define INCL_WININPUT
#define INCL_WINWINDOWMGR
#include <OS2.H>
HWND hwnd;   /* handle of window that has pointer captured */

hwnd = WinQueryCapture(HWND_DESKTOP);  /* window that has   */
                                     /* pointer captured */
</PRE>

==Related Functions==
* [[WinSetCapture]]
[[Category:Win]]