Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-39
USESEGMENT
(superseded by SEGMENT_USE_) Makes a particular extended data segment currently
addressable by the calling process.
You cannot call USESEGMENT directly from a C program, because it returns a value
and also sets the condition-code register. To access this procedure, you must write a
“jacket” procedure in TAL that is directly callable by your C program. For information
on how to do this, see the discussion of procedures that return a value and a condition
code in the C/C++ Programmer’s Guide. Note that the SEGMENT_USE_ procedure,
which should be used in new development, does not require a “jacket” procedure in TAL
to be called from a C program.
VERIFY USER
(superseded by USER_AUTHENTICATE_ and USER_GETINFO_) Controls logons,
verifies that a user exists, and returns user-defaults information.
logon
default
#include <cextdecs(VERIFYUSER)>
_cc_status VERIFYUSER ( short _near *user-name-or-id /* i */
,[ short logon ] /* i */
,[ short _near *default ] /* o */
,short default-len ); /* i */
_status_lt (<returned_value>) A buffer is out of bounds, or an I/O error
occurred on the user ID file
($SYSTEM.SYSTEM.USERID).
_status_eq (<returned_value>) Indicates a successful verification or logon,
or both.
_status_gt (<returned_value>) There is no such user, or the password is
invalid.
0 Verify the user but do not log on.
<> 0 Verify the user and log on.
[0:3] Group name, blank-filled
[4:7] User name, blank-filled
[8] Bits 0-7
Bits 8-15
Group ID
User ID
[9:12] Default volume, blank-filled