PreviousNext

sec_pwd_mgmt_get_val_type(3sec)

Gets users password validation type

Synopsis

#include <dce/sec_pwd_mgmt.h>

void sec_pwd_mgmt_get_val_type(
sec_pwd_mgmt_handle_t pwd_mgmt_h,
signed32 *pwd_val_type
error_status_t *stp
)

Parameters

Input

pwd_mgmt_h
A handle to a user's password management data.

Output

pwd_val_type
The user's password validation type. This is retrieved from the pwd_val_type ERA. The possible values and their meaning are:

0 (none): the user has no password policy.
1 (user_select): the user must choose his/her own password.
2 (user_can_select): the user can choose his/her own password or request a generated password.
3 (generation_required): the user must use a generated password.
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_get_val_type( ) routine returns the value of the user's password validation type, as specified by the pwd_val_type ERA. If the ERA does not exist, 0 (none) is returned in pwd_val_type.

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.

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)