NAME

sec_pwd_mgmt_gen_pwd — Generates a set of passwords

Synopsis

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_pwdsNumber 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. 

stpA 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: pwd_strengthd(8sec), sec_intro(3sec), sec_pwd_mgmt_setup(3sec).