Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-162
PROCESS_SETSTRINGINFO_ Procedure
PROCESS_SETSTRINGINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Example
Considerations
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
•
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.
#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 ] );