Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-32
SEGMENT_GETINFO_ Procedure
SEGMENT_GETINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Related Programming Manual
Summary
The SEGMENT_GETINFO_ procedure retrieves information about a currently
allocated extended data segment.
Syntax for C Programmers
•
The parameter maxlen specifies the maximum length in bytes of the character
string pointed to by
filename, the actual length of which is returned by
filename-len. All three of these parameters must either be supplied or be
absent.
Syntax for TAL Programmers
Note. In the TNS/E environment the CEXTDECS file uses the int data type for 32-bit values.
This is a change from the TNS and TNS/R environments where CEXTDECS uses the long
data type for 32-bit values.
#include <cextdecs(SEGMENT_GETINFO_)>
short SEGMENT_GETINFO_ ( short segment-id
,[ __int32_t *segment-size ]
,[ char *filename ]
,[ short maxlen ]
,[ short *filename-len ]
,[ short *error-detail ]
,[ __int32_t *base-address ]
,[ short *usage-flags ] );
error := SEGMENT_GETINFO_ ( segment-id ! i
,[ segment-size ] ! o
,[ filename:maxlen ] ! o:i
,[ filename-len ] ! o
,[ error-detail ] ! o
,[ base-address ] ! o
,[ usage-flags ] ); ! o