Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-177
CRTPID_TO_PROCESSHANDLE_ Procedure
CRTPID_TO_PROCESSHANDLE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Related Programming Manual
Summary
The CRTPID_TO_PROCESSHANDLE_ procedure converts a process ID (CRTPID) to
the corresponding process handle. Refer to Appendix D, File Names and Process
Identifiers for information about process IDs and process handles.
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
returns a file-system error number indicating the outcome of the operation.
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.
#include <cextdecs(CRTPID_TO_PROCESSHANDLE_ )>
short CRTPID_TO_PROCESSHANDLE_ ( short *process-id
,short *processhandle
,[ short *pair-flag ]
,[ __int32_t node-number ] );
error := CRTPID_TO_PROCESSHANDLE_ ( process-id ! i
,processhandle ! o
,[ pair-flag ] ! o
,[ node-number ] ); ! i