Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-262
PROCESSSTRING_SCAN_ Procedure
PROCESSSTRING_SCAN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The PROCESSSTRING_SCAN_ procedure scans an input string for a process string
and returns the corresponding process handle or a single component of the process
string converted to internal form. Device names are optionally accepted in the input
string. See “Considerations” for the definition of process string.
Syntax for C Programmers
The parameter maxlen specifies the maximum length in bytes of the character string
pointed to by
name, the actual length of which is returned by namelen. All three of
these parameters must either be supplied or be absent.
Syntax for TAL Programmers
#include <cextdecs(PROCESSSTRING_SCAN_)>
short PROCESSSTRING_SCAN_ ( char *string
,[ short length_of_searchString ]
,[ short *length-used ]
,[ short *processhandle ]
,[ short *stringtype ]
,[ char *name ]
,[ maxlen ]
,[ short *namelen ]
,[ short *cpu ]
,[ short *pin ]
,[ short options ] );
error := PROCESSSTRING_SCAN_ ( string:length ! i:i
,[ length-used ] ! o
,[ processhandle ] ! o
,[ stringtype ] ! o
,[ name:maxlen ] ! o:i
,[ namelen ] ! o
,[ cpu ] ! o
,[ pin ] ! o
,[ options ] ); ! i