The LGI$ICB_CHECK_PASS callback routine checks a password against
the user authorization file (UAF) record.
Format
LGI$ICB_CHECK_PASS password ,uaf_record ,pwd_number
1 – Returns
OpenVMS usage:value
type: longword (unsigned)
access: write only
mechanism: by value
The value 1 for a valid password. The value -4 for an invalid
password.
2 – Arguments
password
OpenVMS usage:character string
type: string descriptor
access: read only
mechanism: by reference
User-supplied password to be validated.
uaf_record
OpenVMS usage:buffer
type: vector_byte (unsigned)
access: read only
mechanism: by reference
Address of buffer containing UAF record.
pwd_number
OpenVMS usage:value
type: longword (unsigned)
access: read only
mechanism: by value
Password number, 0 (primary) or 1 (secondary).
3 – Description
The site uses this callback routine to check the user-supplied
password against the UAF record provided as the second argument.
If the password is valid, the routine returns a 1 in R0; if the
password is invalid, the routine returns a -4 in R0.
4 – Condition Values Returned
None.