Guardian Programming Reference Summary for C

Guardian Programming Reference Summary for C—522630-001

6-1

Functions Summary (G-N)

This section lists functions in alphabetic order and briefly describes the syntax of each.

For additional information about the functions, refer to the Guardian Procedure Calls

Reference Manual.

GETPCPBINFO

Provides a process with information from its own (the current) process control block

(PCB).

request-id

#include <cextdecs(GETCPCBINFO)>

void GETCPCBINFO ( short request-id /* i */

,short _near *cpcb-info /* o */

,short in-length /* i */

,short _near *out-length /* o */

,short _near *error ); /* o */

0 = Remote creator flag; returns 1 in cpcb-info if creator was remote.

1 = Logged-on process state; returns 1 in cpcb-info if the process has logged on.

2 = Safeguard-authenticated logon flag; returns 1 in cpcb-info if the process was

started after you successfully logged on to a terminal owned by Safeguard.

3 = Safeguard-authenticated logoff state; returns 1 in cpcb-info if the Safeguard-

authenticated logon flag is set but the process has logged off.

4 = Inherited-logon flag; returns 1 in cpcb-info if the logon was inherited by the

process.

5 = 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.

6 = Propagate-logon flag; returns 1 in cpcb-info if the process’s local

descendants are to be created with the inherited-logon flag set.

7 = Propagate-stop-on-logoff flag; returns 1 in cpcb-info if the process’s local

descendants are to be created with the stop-on-logoff flag set.

16 = Logon flags and states; returns current settings of all the logon flags and state

indicators in cpcb-info.