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 |