win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinQueryWindowUShort (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
USHORT WinQueryWindowUShort(hwnd, index)
HWND hwnd;      /* handle of the window       */
SHORT index;    /* index of value to retrieve */
 
The WinQueryWindowUShort function retrieves an unsigned short integer value
at a specified offset into the reserved memory of a given window.
 
The window handle that is passed to this function can be the handle of a
window with the same or a different message queue from the caller; that is,
this function allows the caller to obtain data from windows belonging to
other threads.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwnd       Identifies the window to query.
 
index      Specifies the zero-based index of the USHORT value to retrieve.
           Valid values are in the range zero through the number of bytes of
           window data (for example, a value of 8 would be an index to the
           fifth integer), or any of the following QWS values:
 
           Value     Meaning
           ─────────────────────────────────────────────────────────────────
           QWS_ID    Window identifier (as passed by the WinCreateWindow
                     function).
 
           QWS_USER  USHORT value present in windows of the following
                     preregistered window classes:
 
                          WC_DIALOG
                          WC_FRAME
                          WC_LISTBOX
                          WC_BUTTON
                          WC_STATIC
                          WC_ENTRYFIELD
                          WC_SCROLLBAR
                          WC_MENU
 
           This value can be used to retrieve application-specific data in
           controls.
 
Return Value
 
The return value is the USHORT value in the window's reserved memory.
 
See Also
 
WinCreateWindow, WinQueryWindowULong, WinRegisterClass, WinSetWindowUShort