Guardian Procedure Calls Reference Manual

PROCESS_GETPAIRINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The PROCESS_GETPAIRINFO_ procedure obtains basic information about a named process or
process pair. You can specify the named process or process pair that you want information about
in one of several ways:
• Supply a process handle in the processhandle parameter. For a process pair, supply the
process handle of either the primary or backup process.
• Supply a process file name in the pair:maxlen parameter.
• Perform an indexed search of the named processes on a system by supplying an initial value
for the search-index parameter and making repeated calls. See Considerations (page 1049)
for details.
To obtain additional information about a named or unnamed process, call either the
PROCESS_GETINFO_ or PROCESS_GETINFOLIST_ procedure.
Syntax for C Programmers
#include <cextdecs(PROCESS_GETPAIRINFO_)>
short PROCESS_GETPAIRINFO_ ( [ short *processhandle ]
,[ char *pair ]
,[ short maxlen ]
,[ short *pair-length ]
,[ short *primary-processhandle ]
,[ short *backup-processhandle ]
,[ __int32_t *search-index ]
,[ short *ancst-processhandle ]
,[ const char *search-nodename ]
,[ short length ]
,[ short options ]
,[ char * ancst ]
,[ short maxlen ]
,[ short * ancst-length ]
,[ short * error-detail ] );
• 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.
PROCESS_GETPAIRINFO_ Procedure 1045