Guardian Procedure Calls Reference Manual

PROCESS_SETSTRINGINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The PROCESS_SETSTRINGINFO_ procedure alters a single string-form attribute of a specified
process, and optionally returns the prior value of the attribute.
You can use the PROCESS_SETINFO_ procedure to alter nonstring process attributes.
Syntax for C Programmers
#include <cextdecs(PROCESS_SETSTRINGINFO_)>
short PROCESS_SETSTRINGINFO_ ( [ short *processhandle ]
,[ short specifier ]
,short set-attr-code
,const char *set-value
,short length
,[ char *old-value ]
,[ short maxlen ]
,[ short *old-value-len ] );
• The parameter length specifies the length in bytes of the character string pointed to by
set-value. The parameters set-value and length must either both be supplied or both
be absent.
• The parameter maxlen specifies the maximum length in bytes of the character string pointed
to by old-value, the actual length of which is returned by old-value-len. All three of
these parameters must either be supplied or be absent.
Syntax for TAL Programmers
error := PROCESS_SETSTRINGINFO_ ( [ processhandle ] ! i
,[ specifier ] ! i
,set-attr-code ! i
,set-value:length ! i:i
,[ old-value:maxlen ] ! o:i
,[ old-value-len ] ) ! o
Parameters
processhandle
input
INT .EXT:ref:10
is a process handle that specifies the process of interest. If this parameter is omitted or null, the
caller is the process of interest. The null process handle is one which has -1 in each word. (For
details, see the PROCESSHANDLE_NULLIT_ Procedure (page 1140).) However,
1092 Guardian Procedure Calls (P)