FTAM/9000 Programmer's Guide

Chapter 4 173
Using Support Functions
Managing Memory
em_fdmemory() Parameters
ft_fdmemory()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_fdmemory (memory_pointer, result)
Octet *memory_pointer;
Api_rc *result;
Use ft_fdmemory() to free dynamic memory allocated for ft_gperror()
return_code and vendor_code strings. Note, if you supplied the memory
for ft_gperror(), do not use ft_fdmemory() to free it.
• You may receive unpredictable results if using free() for memory
allocated by the FTAM library.
• The outcome of ft_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.
em_fdmemory()
Parameter
Type Description
memory_pointer Mandatory
Input
Points to the beginning of the string; address of the
dynamic memory to free (allocated by em_gperror())
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)