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

 NAME
   sec_rgy_unix_getpwuid - Returns a UNIX style passwd entry for the
                           account matching the specified UID

 SYNOPSIS

   #include <dce/rgynbase.h>

   void sec_rgy_unix_getpwuid(
           sec_rgy_handle_t context,
           signed32 uid,
           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.

   uid    A 32-bit integer UNIX ID.

   Input/Output

   item_cursor
          An opaque pointer indicating a specific PGO item entry in the
          registry database. The sec_rgy_unix_getpwuid() 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 password structure returned with information
          about the account matching uid.

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

 DESCRIPTION

   The sec_rgy_unix_getpwuid() routine looks up the next passwd entry
   in the registry that matches the input UNIX ID and returns the
   corresponding sec_rgy_passwd structure.  The structure is in the
   following form:

        typedef struct {
              sec_rgy_unix_login_name_t   name;
              sec_rgy_unix_passwd_buf_t   passwd;
              signed32                    Vuid;
              signed32                    Vgid;
              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

 FILES

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

   This call is provided in source code form.

 ERRORS

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

   sec_rgy_server_unavailable
                The DCE Registry Server is unavailable.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro