Guardian Procedure Calls Reference Manual

POOL_RESIZE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The POOL_RESIZE_ procedure changes the size of a pool that was initialized by the POOL_DEFINE_
procedure.
Syntax for C Programmers
#include <cextdecs(POOL_RESIZE_)>.
short POOL_RESIZE_ ( short *pool
,__int32_t new-pool-size );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := POOL_RESIZE_ ( pool ! i
,new-pool-size ); ! i
Parameters
pool
input
INT .EXT:ref:*
is the address of the pool as specified in the call to the POOL_DEFINE_ procedure. When
POOL_RESIZE_ is called, the pool header is updated.
new-pool-size
input
INT(32):value
specifies the new size of the pool, including the pool header, in bytes. The maximum size is
limited only by the amount of space available to the application. The address of the end of the
pool is always equal to the address specified for the pool parameter plus the value of the
new-pool-size parameter. Pool space overhead and adjustments for alignment do not cause
the pool to extend past this boundary.
POOL_RESIZE_ Procedure 951