Guardian Procedure Calls Reference Manual

filename-length
output
INT .EXT:ref:1
is the actual length of the value returned in filename. If an error other than 18 (unknown
system) is returned, 0 is returned for this parameter.
options
input
INT:value
specifies options. The fields are:
Not currently used (specify 0)<0:14>
For named processes: if set, specifies that the sequence number not be included in filename for a
named process. If this bit is not set, the sequence number is included. For unnamed processes: the
sequence number is always included in filename, regardless of the value of this bit.
<15>
The default is 0.
Returned Value
INT
A file-system error code that indicates the outcome of the call. If error 18 (unknown system) is
returned, the process handle was converted except for the system name; "\255" is used for the
system name.
Considerations
If the process is named, PROCESSHANDLE_TO_FILENAME_ looks up the process name in the
destination control table (DCT). If the name is not found, error 14 is returned. However, it is
sometimes possible for the name of a nonexistent process to be found in the DCT, in which case
error 0 is returned. Therefore, even for a named process, error 0 (successful conversion of a process
handle) does not guarantee that the process exists.
Related Programming Manual
For programming information about the PROCESSHANDLE_TO_FILENAME_ procedure, see the
Guardian Programmer's Guide.
1144 Guardian Procedure Calls (P)