NAME

sec_pwd_mgmt_setup — Sets up the user’s password policy information

Synopsis

void sec_pwd_mgmt_setup(
sec_pwd_mgmt_handle_t ∗pwd_mgmt_h,
sec_rgy_handle_t context,
sec_rgy_login_name_t login_name,
sec_login_handle_t your_lc,
rpc_binding_handle_t pwd_mgmt_bind_h,
error_status_t ∗stp);

Parameters

Input

contextA registry server handle indicating the desired registry site. 

login_name
The login name of the user.

your_lcThe login context handle of the user currently logged in.  If null is specified, the default login context will be used. 

pwd_mgmt_bind_h
An RPC binding handle to the password management server.  Use of this parameter is currently unsupported.  The password management server binding handle will be retrieved from the pwd_mgmt_binding ERA. Set this parameter to NULL. 

Output

pwd_mgmt_h
A pointer to an opaque handle to password management/policy data. pwd_mgmt_h contains, among other data, the account name, values of password management ERAs, and a binding handle to the password management server. 

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

Description

The sec_pwd_mgmt_setup() routine collects the data required to perform remote password management calls to the password management server. 

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_s_no_memory
Not enough memory is available to complete the operation.

sec_rgy_server_unavailable
The network registry is not available.

error_status_ok
The call was successful.

Related Information

Functions: pwd_strengthd(8sec), sec_intro(3sec), sec_pwd_mgmt_free_handle(3sec), sec_pwd_mgmt_gen_pwd(3sec), sec_pwd_mgmt_get_val_type(3sec).