PreviousNext

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)