Guardian Procedure Calls Reference Manual

VERIFYUSER Procedure (Superseded by USER_AUTHENTICATE_ Procedure
and USER_GETINFO_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development. This procedure does not support aliases or groups.
The VERIFYUSER procedure has three different functions. It is used to control logons, to verify that
a user exists, and to return user-default information. Logon control and user verification is also
available through the USER_AUTHENTICATE_ procedure. User-default information is also available
through USER_GETINFO_ without the security restrictions and password validation required by
VERIFYUSER.
Syntax for C Programmers
#include <cextdecs(VERIFYUSER)>
_cc_status VERIFYUSER ( short _near *user-name-or-id
,[ short logon ]
,[ short _near *default ]
,[ short default-len ] );
• The function value returned by VERIFYUSER, which indicates the condition code, can be
interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the file tal.h).
Syntax for TAL Programmers
CALL VERIFYUSER ( user-name-or-id ! i
,[ logon ] ! i
,[ default ! o
,[ default-len ] ); ! i
Parameters
user-name-or-id
input
INT:ref:12
is an array containing the name or user ID of the user to be verified or logged on, as follows:
group name, blank-filled[0:3]
member name, blank-filled[4:7]
The group name and member name must both be input in uppercase.
1482 Guardian Procedure Calls (T-V)