Guardian Procedure Calls Reference Manual

PROCESSHANDLE_TO_FILENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The PROCESSHANDLE_TO_FILENAME_ procedure converts a process handle to a process file
name.
Syntax for C Programmers
#include <cextdecs(PROCESSHANDLE_TO_FILENAME_)>
short PROCESSHANDLE_TO_FILENAME_ ( short *processhandle
,char *filename
,short maxlen
,short *filename-length
,[ short options ] );
Syntax for TAL Programmers
error := PROCESSHANDLE_TO_FILENAME_ ( processhandle ! i
,filename:maxlen ! o:i
,filename-length ! o
,[ options ] ); ! i
Parameters
process handle
input
INT .EXT:ref:10
is the process handle to be converted. If a null process handle (-1 in each word) is specified,
the process handle of the calling process is used.
filename:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the process file name of the process designated by processhandle. filename
includes the node name of the process; it does not include qualifiers.
maxlen is the length in bytes of the string variable filename.
PROCESSHANDLE_TO_FILENAME_ Procedure 1143