Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-219
PROCESSHANDLE_TO_CRTPID_ Procedure
PROCESSHANDLE_TO_CRTPID_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The PROCESSHANDLE_TO_CRTPID_ procedure converts a process handle to the
corresponding process ID (CRTPID). Refer to Appendix D, File Names and Process
Identifiers for a description of process IDs.
Syntax for C Programmers
•
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
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
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.
#include <cextdecs(PROCESSHANDLE_TO_CRTPID_)>
short PROCESSHANDLE_TO_CRTPID_ ( short *processhandle
,short *process-id
,[ short pair-flag ]
,[ __int32_t node-number ] );
error := PROCESSHANDLE_TO_CRTPID_ ( processhandle ! i
,process-id ! o
,[ pair-flag ] ! i
,[ node-number ] ); ! i