Guardian Procedure Calls Reference Manual

FILENAME_TO_PROCESSHANDLE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The FILENAME_TO_PROCESSHANDLE_ procedure converts a file name to a process handle.
Syntax for C Programmers
#include <cextdecs(FILENAME_TO_PROCESSHANDLE_)>
short FILENAME_TO_PROCESSHANDLE_ ( const char *filename
,short length
,short *processhandle );
Syntax for TAL Programmers
error := FILENAME_TO_PROCESSHANDLE_ ( filename:length ! i:i
,processhandle ); ! o
Parameters
filename:length
input:input
STRING .EXT:ref:*, INT:value
contains the valid process file name to be translated. The value of filename must be exactly
length bytes long. If qualifiers are present, they are ignored. If a node name is not present,
the current default node name in the =_DEFAULTS DEFINE is used. See caution under
Considerations.
processhandle
output
INT .EXT:ref:10
returns the process handle of the process designated by filename.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
600 Guardian Procedure Calls (F)