WOWGlobalAllocLock16

  • Article

The WOWGlobalAllocLock16 function combines the functionality of the WOWGlobalAlloc16 and WOWGlobalLock16 functions. This function can only be called in the context of a thunk.

DWORD WINAPI WOWGlobalAllocLock16(
  WORD wFlags,
  DWORD cb,
  LPWORD phMem
);

Parameters

  • wFlags
    [in] Specifies how to allocate memory. This parameter can be one or more of the following values.

    GHND
    GMEM_DDESHARE
    GMEM_DISCARDABLE
    GMEM_FIXED
    GMEM_LOWER
    GMEM_MOVEABLE
    GMEM_NOCOMPACT
    GMEM_NODISCARD
    GMEM_NOT_BANKED
    GMEM_NOTIFY
    GMEM_SHARE
    GMEM_ZEROINIT
    GPTR

  • cb
    [in] Specifies the number of bytes to allocate.

  • phMem
    [in] Handle to the object in the 16-bit global heap. This value is returned by WOWGlobalAllocLock16.

Return Value

Returns a pointer to the first byte of the 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

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
WOWGetVDMPointerFix
WOWGlobalAlloc16
WOWGlobalLock16