sec_pwd_mgmt_setup(3sec)
Sets up the user's password policy information
Synopsis
#include <dce/sec_pwd_mgmt.h>
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
context
A registry server handle indicating the desired registry site.
login_name
The login name of the user.
your_lc
The 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.
stp
A 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:
sec_pwd_mgmt_free_handle(3sec)
sec_pwd_mgmt_get_val_type(3sec)
pwd_strengthd(8sec)