Guardian Procedure Calls Reference Manual

PROCESSHANDLE_TO_STRING_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The PROCESSHANDLE_TO_STRING_ procedure converts a process handle to the equivalent process
string. See Considerations (page 1146), for a description of process strings.
Syntax for C Programmers
#include <cextdecs(PROCESSHANDLE_TO_STRING_)>
short PROCESSHANDLE_TO_STRING_ ( short *processhandle
,char *process-string
,short maxlen
,short *process-string-length
,[ char *nodename ]
,[ short length ]
,[ short named-form ] );
The parameter length specifies the length in bytes of the character string pointed to by nodename.
The parameters nodename and length must either both be supplied or both be absent.
Syntax for TAL Programmers
error := PROCESSHANDLE_TO_STRING_ ( processhandle ! i
,process-string:maxlen ! o:i
,process-string-length ! o
,[ nodename:length ] ! i:i
,[ named-form ] ); ! i
Parameters
processhandle
input
INT .EXT:ref:10
is the process handle to be converted.
process-string:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns a process string that represents the process designated by processhandle. The node
name is included in process-string, except as described under nodename.
maxlen is the length in bytes of the string variable process-string.
PROCESSHANDLE_TO_STRING_ Procedure 1145