WOWHandle16

The WOWHandle16 function is used to map a 32-bit handle to a 16-bit handle. Because the relationship between these handles may change in the future, use this function to convert handles instead of any knowledge of the relationship between them.

This function can only be called in the context of a thunk.

WORD WINAPI WOWHandle16(
  HANDLE Handle,
  WOW_HANDLE_TYPE Type
);

Parameters

• Handle
  [in] The 32-bit handle to be mapped.

• Type
  [in] Specifies the type of handle being translated.

  This parameter can be one of the following values.

  WOW_TYPE_HWND
  WOW_TYPE_HRGN
  WOW_TYPE_HMENU
  WOW_TYPE_HBITMAP
  WOW_TYPE_HDWP
  WOW_TYPE_HBRUSH
  WOW_TYPE_HDROP
  WOW_TYPE_HPALETTE
  WOW_TYPE_HDC
  WOW_TYPE_HPEN
  WOW_TYPE_HFONT
  WOW_TYPE_HACCEL
  WOW_TYPE_HMETAFILE
  WOW_TYPE_HTASK

Return Value

A 16-bit handle.

Remarks

You can also use supplied macros to map handles. For example, to map a 32-bit HWND to a 16-bit HWND, you would use the HWND_16 macro.

(hWnd16 = HWND_16(hWnd32))

WOWHandle16 with WOW_TYPE_HTASK (and HTASK_16) takes a thread identifier and converts it to a handle to a task if possible.

Requirements

Client	Requires Windows XP, Windows 2000 Professional, Windows NT Workstation, Windows Me, Windows 98, or Windows 95.
Server	Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server.
Header	Declared in Wownt32.h.
Library	Use Wow32.lib.
DLL	Requires Wow32.dll.

See Also

Generic Thunks Overview
32-bit Generic Thunk Functions
WOWHandle32