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

 NAME
   sec_pwd_mgmt_gen_pwd  - Generate a set of passwords

 SYNOPSIS
   #include <dce/sec_pwd_mgmt.h>

   void sec_pwd_mgmt_gen_pwd(
           sec_pwd_mgmt_handle_t   pwd_mgmt_h,
           unsigned32              num_pwds,
           unsigned32              *num_returned,
           sec_passwd_rec_t                gen_pwds[],
           error_status_t          *stp
       )

 PARAMETERS

   Input

   pwd_mgmt_h
          A handle to user's password management data.

   num_pwds
          Number of generated passwords requested.

   Output

   num_returned
          Number of generated passwords returned in the gen_pwds[] array.

   gen_pwds
          Array of generated passwords. Each generated password is stored
          in a sec_passwd_rec_t structure.

   stp    A pointer to the completion status.  On successful completion,
          status is assigned error_status_ok.  Otherwise, it returns an
          error.

 DESCRIPTION

   The sec_pwd_mgmt_gen_pwd() routine retrieves a set of generated
   passwords from a password management server which is exporting the
   rsec_pwd_mgmt_gen_pwd() routine. It obtains the binding information
   to this server from the pwd_mgmt_h handle.

 FILES

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

 ERRORS

   sec_rgy_era_pwd_mgmt_auth_type
                The pwd_mgmt_binding ERA must contain authentication
                information.

   sec_pwd_mgmt_svr_unavail
                The password management server is unavailable

   sec_pwd_mgmt_svr_error
                Generic error returned from password management server.
                An administrator should check the password management
                server's log file for more information.

   error_status_ok
                The call was successful

   Various RPC communication errors can be returned if there are failures
   when binding to the password management server.

 RELATED INFORMATION

   Functions: sec_intro
              sec_pwd_mgmt_setup
              pwd_strengthd