Guardian Procedure Calls Reference Manual

GETCPCBINFO Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Example
Summary
The GETCPCBINFO procedure provides a process with information from its own (the current)
process control block (PCB).
Syntax for C Programmers
#include <cextdecs(GETCPCBINFO)>
void GETCPCBINFO ( short request-id
,short _near *cpcb-info
,short in-length
,short _near *out-length
,short _near *error );
Syntax for TAL Programmers
CALL GETCPCBINFO ( request-id ! i
,cpcb-info ! o
,in-length ! i
,out-length ! o
,error ); ! o
Parameters
request-id
input
INT:value
specifies the information to be returned. Each request ID causes a value of type INT to be
returned in cpcb-info. The list of valid request IDs are:
Remote creator flag; returns 1 in cpcb-info if creator was remote.0
Logged-on process state; returns 1 in cpcb-info if the process is currently logged on.1
Safeguard-authenticated logon flag; returns 1 in cpcb-info if the process was started after successfully
logging on via a terminal owned by Safeguard.
2
Safeguard-authenticated logoff state; returns 1 in cpcb-info if the Safeguard-authenticated logon flag
is set but the process has logged off.
3
Inherited-logon flag; returns 1 in cpcb-info if the logon was inherited by the process.4
Stop-on-logoff flag; returns 1 in cpcb-info if the process is to be stopped when it requests to be placed
in the logged-off state.
5
Propagate-logon flag; returns 1 in cpcb-info if the process' local descendants are to be created with
the inherited-logon flag set.
6
Propagate-stop-on-logoff flag; returns 1 in cpcb-info if the process' local descendants are to be created
with the stop-on-logoff flag set.
7
Logon flags and states; returns current settings of all the logon flags and state indicators in cpcb-info.16
GETCPCBINFO Procedure 653