Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(PROCESS_SETINFO_)>
short PROCESS_SETINFO_ ( [ short *processhandle ]
,[ short specifier ]
,short set-attr-code
,[ short *set-value ]
,[ short set-value-len ]
,[ short *old-value ]
,[ short old-value-maxlen ]
,[ short *old-value-len ] );
Syntax for TAL Programmers
error := PROCESS_SETINFO_ ( [ processhandle ] ! i
,[ specifier ] ! i
,set-attr-code ! i
,[ set-value ] ! i
,[ set-value-len ] ! i
,[ old-value ] ! o
,[ old-value-maxlen ] ! 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,
PROCESS_SETINFO_ 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.
Priority is the only attribute that can be altered for either a single member or both members of
a named process pair. Changes to process file security and mom affect only a single process
(specifier is treated as 0). Changes to item 49 (qualifier-info-available) always affect the
named process pair as a whole (specifier is treated as 1).
set-attr-code
input
INT:value
is the code specifying the process attribute to be altered. For more information about process
attributes, see set-attr-code Attribute Codes and Value Representations (page 1087), the
PROCESS_SETINFO_ Procedure 1085