LBuffer::SetHandle

#include "ltwrappr.h"

L_INT LBuffer::SetHandle(pMemHandle, dwSize=0)

HGLOBAL * pMemHandle;

/* pointer to a global memory handle */

L_SIZE_T dwSize;

/* size of the global handle */

Initializes the class object with an allocated global buffer handle.

Parameter

Description

pMemHandle

Pointer to a global memory handle.

dwSize

The size of the global memory handle. Pass 0 to let the function get the size.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

You can use this function to have the class object manipulate a buffer that you have previously allocated. This memory will be automatically freed when the class object is destroyed.

If the object already has an allocated buffer associated with it, that buffer is freed before the new handle is set.

The passed memory handle will be invalidated after this operation.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions:

Class Members

Example

L_INT LBuffer__SetHandleExample()
{
   L_INT nRet;
   LBuffer LeadBuffer ;
   HGLOBAL hGlobal ;
   hGlobal = GlobalAlloc(GMEM_MOVEABLE,1024) ;
   nRet = LeadBuffer.SetHandle (&hGlobal);
   return nRet;
   //...
}