Platform SDK: DLLs, Processes, and Threads

WOWGlobalLock16

The WOWGlobalLock16 function locks a global memory object and returns a pointer to the first byte of the object's memory block. This function can only be called in the context of a thunk.

DWORD WINAPI WOWGlobalLock16(
  WORD hMem  // handle to the global memory object
);

Parameters

hMem
[in] Handle to the object in the 16-bit global heap. This value must have been obtained from the WOWGlobalAlloc16 or WOWGlobalAllocLock16 function.

Return Values

Returns a pointer to the first byte of the object's memory block if successful. Otherwise, returns NULL.

Remarks

The pointer returned is a 16:16 pointer that cannot be dereferenced directly in 32-bit code. Instead, call the WOWGetVDMPointerFix function.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Wownt32.h.
  Library: Included as a resource in Wow32.dll.

See Also

Generic Thunks Overview, 32-bit Generic Thunk Functions, WOWGetVDMPointerFix, WOWGlobalAlloc16, WOWGlobalAllocLock16