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.