Library /sys$common/syshlp/helplib.hlb  —  LGI Routines, LGI$ICB_CHECK_PASS
    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.
Close Help