NetGroupAdd功能在安全数据库中创建一个全局组。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetGroupAdd.
NET_API_STATUS NetGroupAdd
| LPWSTR服务器名称, | |
| DWORD水平, | |
| LPBYTEBUF, | |
| LPDWORDparm_err | |
| ); |
参数
服务器名称
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
水平
指定以下值之一来设置BUF参数中指向的信息级别。
| 值 | 含义 |
| 0 | 指定组名。BUF参数包含指向GROUP_INFO_0结构的指针。 |
| 1 | 指定组名和注释。BUF参数包含指向GROUP_INFO_1结构的指针。 |
| 2 | 指定有关组的信息。BUF参数包含指向GROUP_INFO_2结构的指针。 |
BUF
指向包含全局组信息结构的缓冲区。
parm_err
返回值为DWORD的可选指针返回第一个参数的索引错误,当返回ERROR_INVALID_PARAMETER时。如果为NULL,则不返回错误的参数。
返回值
如果函数成功,返回值为NERR_Success。
如果函数失败,则返回值是以下错误代码之一。
| 值 | 含义 |
| ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
| NERR_InvalidComputer | 计算机名无效。 |
| NERR_GroupExists | 该组已经存在。 |
| NERR_NotPrimary | 该操作只允许在域的主域控制器上。 |
| ERROR_INVALID_LEVEL | 为水平参数指定的值无效。 |
| NERR_SpeGroupOp | 指定的特殊组(用户组,管理员组,本地组或访客组)不允许操作。 |
也可以看看