sec_pwd_mgmt_gen_pwd(3sec)
Generates 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
/usr/include/dce/sec_pwd_mgmt.idl The idl file from which dce/sec_pwd_mgmt.h was derived.
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
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(3sec)
sec_pwd_mgmt_setup(3sec)
pwd_strengthd(8sec)
|