CreateUser
The function CreateUser creates a new user in your project’s security system.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| CreateUser | Security | Synchronous | Supported | Supported | Supported | Not supported |
Syntax
CreateUser(optStrUserName,optStrGroup,optStrPassw,optStrUserFullName)
- optStrUserName
- optStrGroup
- The name of the user to be created, and the group(s) to which the user will belong. You can specify multiple groups by separating them with a comma.
These are optional parameters; if no values are specified, a dialog box will be displayed on the client so that the current user can provide the information.
- optStrPassw
- The user’s password.
This is an optional parameter; if no value is specified, the user will not have a password. (To specify one later, either call the function SetPassword or edit the user’s settings in the project security system.)
- optStrUserFullName
- The full name of the user.
This is an optional parameter; if no value is specified, the user will not have a full name. (To specify one later, edit the user’s settings in the project security system.)
Returned value
| Value | Description |
|---|---|
| -1000 | Could not display dialog box. The function should executed on the client. |
| -1 | Internal error. Please contact Support. |
| 0 | New user created successfully. |
| 1 | Invalid number of parameters. |
| 2 | Wrong parameter type. |
| 3 | User name already exists. |
| 4 | Group does not exist. |
| 5 | Failed to save to configuration file. |
| 6 | Invalid user. |
| 7 | User full name already exists. |
| 8 | Reentrant function call not allowed. |
| 9 | User clicked Cancel on the Create User dialog box. |
| 10 | Invalid password, check the minimum password size specified for the group. |
| 11 | Invalid group. (Group may not have Runtime group option selected.) |
| 12 | Create User dialog box is already displayed, cannot display another dialog box. (For example, if the user clicked OK without providing all of the required information.) |
| 13 | Current user does not have sufficient privileges to create users (i.e., the option Edit Security System is not selected in the Security System settings). |
| 14 | The current Security Mode does not allow a user to be created. |
Notes
Users created with this function have the Runtime user option selected in the User Account dialog. For more information, see Creating and configuring users.
Examples
CreateUser()
CreateUser("Bob","Admin","Chocolate")
CreateUser("Albert","Engineering","EMC2","Albert Jones")