VMS Help DCE_SECURITY, API Routines, sec_pwd_mgmt_setup  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_pwd_mgmt_setup  - 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

   SYS$COMMON:[DCE$LIBRARY]SEC_PWD_MGMT.IDL
          The idl file from which dce/sec_pwd_mgmt.h was derived.

 ERRORS

   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_intro
              sec_pwd_mgmt_free_handle
              sec_pwd_mgmt_gen_pwd
              sec_pwd_mgmt_get_val_type
              pwd_strengthd