Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-109
PROCESS_GETPAIRINFO_ Procedure
Syntax for C Programmers
•
The parameter maxlen specifies the maximum length in bytes of the character
string pointed to by
pair, the actual length of which is returned by pair-length.
All three of these parameters must either be supplied or be absent.
•
The parameter length specifies the length in bytes of the character string pointed
to by
search-nodename. The parameters search-nodename and length
must either both be supplied or both be absent.
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(PROCESS_GETPAIRINFO_)>
short PROCESS_GETPAIRINFO_ ( [ short *processhandle ] /*i 1*/
,[ char *pair ] /* i,o:i 2*/
,[ short maxlen ] /* i,o:i 2*/
,[ short *pair-length ] /* o 3*/
,[ short *primary-processhandle ]/ * o 4*/
,[ short *backup-processhandle ] /* o 5*/
,[ __int32_t *search-index ] /* i, o 6*/
,[ short *ancst-processhandle ] /* o 7*/
,[ const char *search-nodename /* i:i 8*/
,[ short length ] /* i:i 8*/
,[ short options ] /* i,i 9*/
,[ char * ancst] /* i,o:i10*/
,[ short maxlen] /*i,o:i 10*/
,[ short * ancst-length ] /* o 11*/
,[ short * error-detail ]); /*o 12*/