Guardian Procedure Calls Reference Manual

CRTPID_TO_PROCESSHANDLE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The CRTPID_TO_PROCESSHANDLE_ procedure converts a process ID (CRTPID) to the corresponding
process handle. For information about process IDs and process handles, see Appendix D: File
Names and Process Identifiers.
Syntax for C Programmers
#include <cextdecs(CRTPID_TO_PROCESSHANDLE_)>
short CRTPID_TO_PROCESSHANDLE_ ( short *process-id
,short *processhandle
,[ 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 := CRTPID_TO_PROCESSHANDLE_ ( process-id ! i
,processhandle ! o
,[ pair-flag ] ! o
,[ node-number ] ); ! i
Parameters
process-id
input
INT .EXT:ref:4
specifies the process ID (CRTPID) to be converted. If process-id does not include a node
number, the caller's node is assumed.
processhandle
output
INT .EXT:ref:10
returns the process handle of the process designated by process-id.
CRTPID_TO_PROCESSHANDLE_ Procedure 245