Guardian Procedure Calls Reference Manual

PROCESS_SETSTRINGINFO_ also treats a process handle with -1 in the first word as a null
process handle.
specifier
input
INT:value
indicates whether the operation affects both members of a named process pair. Valid values
are:
Act upon the specified process only.0
Act upon both members of current instance of named process pair if processhandle specifies a member
of a named process pair.
1
The default is 0.
A change to the home terminal affects only a single process (specifier is treated as 0).
set-attr-code
input
INT:value
is the code specifying the process attribute to be altered.
set-attr-code can be one of these attributes:
home terminal5 *
The asterisk (*) indicates that the attribute can be altered only when the caller is the target
process.
This is the only attribute that currently can be altered by PROCESS_SETSTRINGINFO_. If a
process alters this attribute, the new home terminal becomes the home terminal for any process
that it subsequently creates.
For more information about process attributes, see the Considerations (page 1094) for this
procedure and the PROCESS_GETINFO_ procedure General Considerations.
set-value:length
input:input
STRING .EXT:ref:*, INT:value
is the new value for the attribute to be altered. The value of set-value must be exactly
length bytes long.
old-value:maxlen
output:input
STRING .EXT:ref:*, INT:value
if present and maxlen is not 0, returns the prior value for the attribute being altered.
old-value-len
output
INT .EXT:ref:1
is the actual length in bytes of old-value. This parameter must be present when old-value
is present. Otherwise, both must be omitted.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
PROCESS_SETSTRINGINFO_ Procedure 1093