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.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
PVOID WinQueryWindowPtr(hwnd, index)
HWND hwnd;      /* handle of the window */
SHORT index;    /* index to the pointer */
 
The WinQueryWindowPtr function retrieves a pointer value from a specified
window's reserved memory.
 
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 that contains the pointer to retrieve.
 
index      Specifies the zero-based index of the pointer 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
           third pointer), or QWP_PFNWP to address the index of the window
           procedure.
 
Return Value
 
The return value is the specified ULONG value in the window's reserved
memory.
 
Comments
 
The specified index is valid only if all the bytes referenced are within the
reserved memory. For example, this function would fail if an index value of
zero was specified and only two bytes had been reserved.
 
See Also
 
WinQueryWindowULong, WinSetWindowPtr
 
                                      ♦