LBuffer::SetHandle
#include "ltwrappr.h"
L_INT LBuffer::SetHandle(pMemHandle, dwSize=0)
|
HGLOBAL L_FAR * pMemHandle; |
/* pointer to a global memory handle */ |
|
DWORD 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. |
See Also
|
Functions: |
Example
L_VOID TestHandle()
{
LBuffer LeadBuffer ;
HGLOBAL hGlobal ;
hGlobal = GlobalAlloc(GMEM_MOVEABLE,1024) ;
LeadBuffer.SetHandle (&hGlobal);
//...
}