FTAM/9000 Programmer's Guide

172 Chapter 4
Using Support Functions
Managing Memory
ft_dfdcb() Parameters
em_fdmemory()
#include %</opt/ftam/include/map.h>
Return_code
em_fdmemory(memory_pointer, result)
Octet *memory_pointer;
Api_rc *result;
Use em_fdmemory() to free dynamic memory allocated by em_gperror()
for the return_code and vendor_code strings. Note, if you supplied the
memory for em_gperror(), do not use em_fdmemory() to free it.
• You may receive unpredictable results if using free() for memory
allocated by em_gperror().
• The outcome of em_fdmemory() does not return in result if you pass
an invalid result structure address on input.
• If you allocated memory yourself (e.g., using malloc()), you must also
free the memory.
ft_dfdcb()
Parameter
Type Description
dcb_pointer Mandatory
Input
Address of the DCB to free
result Output Pointer to the struct Api_rc containing the outcome of
the operation: result_code (MAP 3.0 error) and
vendor_code (HP–UX—specific error)