Guardian Procedure Calls Reference Manual

Considerations
CAUTION: Passing an invalid file name to this procedure can result in a trap, a signal, or data
corruption. To verify that a file name is valid, use the FILENAME_SCAN_ procedure.
• If the file name to be converted by FILENAME_TO_PROCESSHANDLE_ designates something
besides a process (for example, a disk file or a tape device), the procedure returns the process
handle of the process that controls the device (that is, the I/O process).
• When converting the process file name of a named process,
FILENAME_TO_PROCESSHANDLE_ looks up the process by 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 FILENAME_TO_PROCESSHANDLE_ procedure, see the
Guardian Programmer's Guide.
FILENAME_TO_PROCESSHANDLE_ Procedure 601