FTAM/9000 Programmer's Guide

Chapter 4 171

Using Support Functions

Managing Memory

ft_didcb() Parameters

ft_dfdcb()

#include %</opt/ftam/include/map.h>

#include %</opt/ftam/include/mapftam.h>

Return_code

ft_dfdcb (dcb_pointer, result)

Octet *dcb_pointer;

Api_rc *result;

Use ft_dfdcb() to de-allocate memory that was allocated by ft_didcb().

Also use ft_dfdcb() to de-allocate memory if you speciﬁed NULL for the

inout_dcb when calling an FTAM function.

• If you allocated memory (e.g., using malloc()), you cannot call

ft_dfdcb() to de- allocate memory.

• The outcome of ft_dfdcb() does not return in result if you pass an

invalid result structure address on input.

ft_didcb()

Parameter

Type Description

dcb_type Mandatory

Input

Identiﬁes the DCB to initialize

additional_size Optional Input

inout_dcb only

Speciﬁes the amount of memory allocated beyond that

allocated for the DCB

dcb_pointer Input Address of the DCB to initialize

Output Address of the DCB pointer

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—speciﬁc error)