DrgFreeDragtransfer
This function frees the storage associated with a DRAGTRANSFER structure.
Syntax
DrgFreeDragtransfer(pdxfer)
Parameters
- pdxfer (PDRAGTRANSFER) - input
- Pointer to the DRAGTRANSFER structures to be freed.
Returns
- rc (BOOL) - returns
- Return code.
- TRUE - The structure was freed successfully.
- FALSE - The deallocation failed.
Remarks
This function frees the DRAGTRANSFER structures allocated by calls to DrgAllocDragtransfer. When all of the DRAGTRANSFER structures have been freed, the memory block containing the DRAGTRANSFER array is deallocated.
Errors
Possible returns from WinGetLastError:
- PMERR_MEMORY_DEALLOCATION_ERR (0x1113)
- An error occurred during memory management.
Example Code
#define INCL_WINSTDDRAG /* Direct Manipulation (Drag) Functions */ #include <os2.h> BOOL fSuccess; /* Indicate success or failure */ DRAGTRANSFER dxfer; /* Pointer to DRAGTRANSFER structure */ fSuccess = DrgFreeDragtransfer(&dxfer);