User Modal Functions

The user modal functions control the system-wide parameters that affect the Windows NT Security system behavior. The user modal functions are:

NetUserModalsGet
NetUserModalsSet

The NetUserModalsGet and NetUserModalsSet functions examine and modify the modal settings, which are global parameters that affect every account in the database (for example, the minimum allowable password length). All modal settings can be altered by calling NetUserModalsSet . Most of the modals can also be altered by using the net accounts command. The NetUserModalsGet and NetUserModalsSet functions do not require the server to have user-level security.

User modal information is available at four levels:

USER_MODALS_INFO_0
USER_MODALS_INFO_1
USER_MODALS_INFO_2
USER_MODALS_INFO_3

The following information levels are valid only for NetUserModalsSet and replace the older way of passing in a Parmnum to set a specific field:

USER_MODALS_INFO_1001
USER_MODALS_INFO_1002
USER_MODALS_INFO_1003
USER_MODALS_INFO_1004
USER_MODALS_INFO_1005
USER_MODALS_INFO_1006
USER_MODALS_INFO_1007

For NetUserModalsSet, parmnum values refer to the members of the MODALS_INFO structure, as follows. These values are used when indicating an error in a specific parameter through parm_err.

parmnum value Member of modals_info structure
MODALS_MIN_PASSWD_LEN_PARMNUM usrmod_min_passwd_len
MODALS_MAX_PASSWD_AGE_PARMNUM usrmod_max_passwd_age
MODALS_MIN_PASSWD_AGE_PARMNUM usrmod_min_passwd_age
MODALS_FORCE_LOGOFF_PARMNUM usrmod_force_logoff
MODALS_PASSWD_HIST_LIST_PARMNUM usrmod_passwd_hist_list
MODALS_ROLE_PARMNUM usrmod_role
MODALS_PRIMARY_PARMNUM usrmod_primary
MODALS_DOMAIN_NAME_PARMNUM usrmod_domain_name
MODALS_DOMAIN_ID_PARMNUM usrmod_domain_id