Guardian Procedure Calls Reference Manual

PROCESSHANDLE_TO_CRTPID_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The PROCESSHANDLE_TO_CRTPID_ procedure converts a process handle to the corresponding
process ID (CRTPID). For a description of process IDs, see Appendix D: File Names and Process
Identifiers.
Syntax for C Programmers
#include <cextdecs(PROCESSHANDLE_TO_CRTPID_)>
short PROCESSHANDLE_TO_CRTPID_ ( short *processhandle
,short *process-id
,[ short pair-flag ]
,[ __int32_t node-number ] );
• 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 := PROCESSHANDLE_TO_CRTPID_ ( processhandle ! i
,process-id ! o
,[ pair-flag ] ! i
,[ node-number ] ); ! i
Parameters
processhandle
input
INT .EXT:ref:10
is the process handle to be converted. An error value of 590 is returned if processhandle
is null (-1 in each word) or has an invalid format.
process-id
output
INT .EXT:ref:4
returns the process ID (CRTPID) of the process designated by processhandle. If the process
is named and local to the node indicated by node-number, the process ID is in local form.
In all other cases the process ID is in network form.
PROCESSHANDLE_TO_CRTPID_ Procedure 1141