Returns authorization information about a specified user.

    Format

      SYS$GETUAI  [nullarg] ,[contxt] ,usrnam ,itmlst ,[nullarg]

                  ,[nullarg] ,[nullarg]

    C Prototype

      int sys$getuai  (unsigned int efn, unsigned int *contxt, void

                      *usrnam, void *itmlst, struct _iosb *iosb, void

                      (*astadr)(__unknown_params), int astprm);

1  –  Arguments

 nullarg

    OpenVMS usage:null_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument reserved to HP.

 contxt

    OpenVMS usage:longword
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    An optional longword used to maintain an open channel to the
    authorization file. The contxt argument is the address of a
    longword to receive a $GETUAI context value. If the contxt
    argument is specified on the initial call, this longword should
    contain the value -1, and on subsequent calls, the value of the
    contxt argument from the previous call should be passed back in.

 usrnam

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Name of the user about whom $GETUAI returns authorization
    information. The usrnam argument is the address of a descriptor
    pointing to a character text string containing the user name.
    The user name string can contain a maximum of 12 alphanumeric
    characters.

 itmlst

    OpenVMS usage:item_list_3
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Item list specifying which information from the specified user's
    user authorization file (UAF) record is to be returned. The
    itmlst argument is the address of a list of one or more item
    descriptors, each of which specifies an item code. The item list
    is terminated by an item code value of 0 or by a longword value
    of 0.

    To view the item code diagram and descriptor fields table, see
    the HP OpenVMS System Services Reference Manual.

 nullarg

    OpenVMS usage:nullarg
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference
    Placeholding argument reserved to HP.

 nullarg

    OpenVMS usage:nullarg
    type:         procedure entry mask
    access:       call without stack unwinding
    mechanism:    by reference
    Placeholding argument reserved to HP.

 nullarg

    OpenVMS usage:nullarg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument reserved to HP.