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 | 指定的特殊组(用户组,管理员组,本地组或访客组)不允许操作。 |
也可以看看