NetUserAdd功能添加用户帐户并分配密码和权限级别。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetUserAdd.只有管??理员本地组的成员才能添加管理员权限帐户。
NET_API_STATUS NetUserAdd
| LPWSTR服务器名称, | |
| DWORD水平, | |
| LPBYTEBUF, | |
| LPDWORDparm_err | |
| ); |
参数
服务器名称
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
水平
指定以下值之一来设置提供的信息级别。
| 值 | 含义 |
| 1 | BUF参数指向USER_INFO_1结构。 |
| 2 | BUF参数指向USER_INFO_2结构。 |
| 3 | BUF参数指向USER_INFO_3结构。 |
BUF
指向存储有水平参数的数据的缓冲区的指针。
parm_err
可选的指向DWORD的指针，其中包含导致ERROR_INVALID_PARAMETER的第一个参数的索引。如果为NULL，则不返回错误的参数。
返回值
如果函数返回帐户信息，返回值为NERR_Success。
如果函数失败，则返回值是以下错误代码之一。
| 值 | 含义 |
| ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
| NERR_InvalidComputer | 计算机名无效。 |
| NERR_NotPrimary | 该操作只允许在域的主域控制器上。 |
| NERR_GroupExists | 该组已经存在。 |
| NERR_UserExists | 用户帐户已经存在。 |
| NERR_PasswordTooShort | 密码短于所需密码。 |
备注
服务器用户必须使用服务器为新用户创建WINDOWS NT系统帐户的系统。此帐户的创建由服务器的LANMAN.INI文件中的几个参数控制。
如果新添加的服务器用户名已经作为Windows NT系统用户存在，The following are possible default values. USER_INFO_1结构的成员将被忽略。NetUserAdd功能支持USER_INFO_1和USER_INFO_2结构。使用USER_INFO_1的成员初始化USER_INFO_2和USER_INFO_3结构中的默认值。
随后的NetUserSetInfo呼叫可以更改默认值。以下是可能的默认值。
| 会员 | 默认值 |
| None (0) | 无（0） |
| usriX_usr_comment | usri1_name |
| None (null string) | 无（空字符串） |
| usriX_workstations | 无（空字符串） |
| All (null string) | 全部（空字符串） |
| Never (TIMEQ_FOREVER) | 从不（TIMEQ_FOREVER） |
| Unlimited (USER_MAXSTORAGE_UNLIMITED) | 无限（USER_MAXSTORAGE_UNLIMITED） |
| usriX_logon_server | 随时登录（每个元素0xFF;所有位设置为1） |
| Any domain controller (\\*) | 任何域控制器（\\\\ *） |
| Current (country_code on the server | 当前（服务器上的country_code） |
| Requirements | 0 |
也可以看看
