NetGroupSetUsers函数设置指定全局组的全局组成员资格。指定的每个用户都是全局组的成员。未指定但目前为全球组成员的用户将被撤销。
NetGroupSetUsers的一个用途是用全新的成员资格替换当前的会员资格。典型的顺序是使用NetGroupGetUsers函数,修改返回的成员列表以查看您想要的方式,然后调用NetGroupSetUsers.
安全要求
只有Administrators或Account Operators本地组的成员才能在远程服务器上成功执行NetGroupSetUsers.
NET_API_STATUS NetGroupSetUsers(
LPWSTR【服务器名称】, | |
LPWSTR【GROUPNAME】, | |
DWORD【水平】, | |
LPBYTE【BUF】, | |
DWORD【NewMemberCount】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【GROUPNAME】
指向包含指定用户所属的全局组名称的Unicode字符串。
【水平】
指定以下值之一来设置【BUF】参数中指向的信息级别。
值 | 含义 |
0 | 指定组名。指定的缓冲区指向GROUP_USERS_INFO_0结构的数组。 |
1 | 指定组属性。指定的缓冲区指向GROUP_USERS_INFO_1结构的数组。 |
【BUF】
指向指定数据的缓冲区位置。
【NewMemberCount】
指定【BUF】指向的缓冲区中的条目数。
返回值
如果函数成功,返回值为NERR_Success。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_NotPrimary | 该操作只允许在域的主域控制器上。 |
NERR_GroupNotFound | 找不到组名。 |
NERR_UserNotFound | 无法找到用户名。 |
NERR_SpeGroupOp | 指定的特殊组(用户组,管理员组,本地组或访客组)不允许操作。 |
也可以看看