gtpc2m5z | C/C++ Language Support User's Guide |
This function releases chained pool record addresses from the record first specified through the end of chain using standard TPF record headers. The input argument hdr may point at any standard header. The record ID and the record code check for all records in the chain must match the header pointed to by hdr.
Format
#include <tpfapi.h> void rlcha(struct stdhdr *hdr);
or
#include <tpfapi.h> #include <c$std8.h> void rlcha(struct istd8 *hdr);
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
Examples
The following example starts the release of the chain of pool record addresses beginning with the address found in the standard header on level D5.
#include <tpfapi.h> struct stdhdr *cp0hdr;
·
·
·
cp0hdr = ecbptr()->ce1cr5; rlcha(cp0hdr);
The following example starts the release of the chain of pool record addresses beginning with the address found in the 8-byte standard header on the DECB pointed to by decb_ptr.
#include <tpfapi.h> #include <istd8.h> #include <i$decb.h> TPF_DECB *decb_ptr; DECBC_RC rc; struct istd8* block_header decb_ptr = tpf_decb_create( NULL, &rc );
·
·
·
block_header = (istd8 *)decb_ptr->idecdad; rlcha( block_header );
Related Information