VMS Help DCE_SECURITY, API Routines, sec_rgy_unix_getpwnam  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_rgy_unix_getpwnam - Returns a UNIX style passwd entry for account
                           matching the specified name.

 SYNOPSIS

   #include <dce/rgynbase.h>
   void sec_rgy_unix_getpwnam (
   sec_rgy_handle_t context,
   sec_rgy_name_t name,
   unsigned32 name_len,
   sec_rgy_cursor_t *item_cursor,
   sec_rgy_unix_passwd_t *passwd_entry,
   error_status_t *status);

 PARAMETERS

   Input

   context   An opaque handle bound to a registry server. Use
             sec_rgy_site_open to acquire a bound handle.

   name      A character string (of type sec_rgy_name_t) containing the
             name of the person, group, or organization whose name entry
             is desired.

   name_len  A 32-bit integer representing the length of the name in
             characters.

   Input/Output

   item_cursor
             An opaque pointer indicating a specific PGO item entry in
             the registry database. The sec_rgy_unix_getpwnam routine
             returns the PGO item indicated by item_cursor, and advances
             the cursor to point to the next item in the database.  When
             the end of the list of entries is reached, the routine
             returns sec_rgy_no_more_entries.  Use sec_rgy_cursor_reset
             to refresh the cursor.

   Output

   passwd_entry
             A UNIX style passwd structure returned with information
             about the account matching name.

   status    On successful completion, the routine returns
             error_status_ok.  Otherwise, it returns an error.

 DESCRIPTION

   The sec_rgy_unix_getpwnam routine returns the next UNIX passwd
   structure that matches the input name.  The structure is in the form:

         typedef struct {
                sec_rgy_unix_login_name_t   name;
                sec_rgy_unix_passwd_buf_t   passwd;
                signed32                    uid;
                signed32                    gid;
                signed32                    oid;
                sec_rgy_unix_gecos_t        gecos;
                sec_rgy_pname_t             homedir;
                sec_rgy_pname_t             shell;
            }               sec_rgy_unix_passwd_t;

   The structure includes:

     +  The account's login name.

     +  The account's password.

     +  The account's UNIX ID.

     +  The UNIX ID of group and organization associated with the
        account.

     +  The account's GECOS information.

     +  The account's home directory.

     +  The account's login shell

   This call is provided in source code form.

 FILES

   SYS$COMMON:[DCE$LIBRARY]RGYNBASE.IDL
             The idl file from which rgynbase.h was derived.

 ERRORS

   sec_rgy bad_data
                  The name supplied as input was too long.

   error_status_ok
                  The call was successful.

   sec_rgy_no_more_entries
                  The end of the list of entries has been reached.

 RELATED INFORMATION

   Functions: sec_intro