Guardian Procedure Calls Reference Manual

PROCESSHANDLE_COMPARE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The PROCESSHANDLE_COMPARE_ procedure compares two process handles and reports whether
they are identical, represent different processes of the same process pair, or different.
PROCESSHANDLE_COMPARE_ is primarily useful for determining whether processes form a
process pair. You can determine whether two process handles are identical by doing a ten-word
unsigned comparison.
Syntax for C Programmers
#include <cextdecs(PROCESSHANDLE_COMPARE_)>
short PROCESSHANDLE_COMPARE_ ( short *processhandle-1
,short *processhandle-2 );
Syntax for TAL Programmers
status := PROCESSHANDLE_COMPARE_ ( processhandle-1 ! i
,processhandle-2 ); ! i
Parameters
processhandle-1
input
INT .EXT:ref:10
is one of the process handles to be compared.
processhandle-2
input
INT .EXT:ref:10
is the other process handle to be compared.
Returned Value
INT
The result of the comparison:
Process handles are unrelated.0
Process handles are not identical but designate a process pair.1
Process handles are identical.2
1134 Guardian Procedure Calls (P)