NetUserSetGroups功能为指定的用户帐户设置全局组成员资格。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetUserSetGroups.
NET_API_STATUS NetUserSetGroups(
LPWSTR【服务器名称】, | |
LPWSTR【用户名】, | |
DWORD【水平】, | |
LPBYTE【BUF】, | |
DWORD【NUM_ENTRIES】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【用户名】
指向包含用于设置全局组成员资格的用户名称的Unicode字符串。
【水平】
指定以下值之一来设置提供的信息级别。
值 | 含义 |
0 | 【BUF】参数指向GROUP_USERS_INFO_0结构的数组。 |
1 | 【BUF】参数指向GROUP_USERS_INFO_1结构的数组。 |
【BUF】
指向存储有【水平】参数的数据的缓冲区的指针。返回的缓冲区应使用NetApiBufferFree功能取消分配。
【NUM_ENTRIES】
【BUF】指向的阵列中包含的全局组信息结构数。
返回值
如果该函数成功,则返回NERR_SUCCESS。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_NotPrimary | 该操作只允许在域的主域控制器上。 |
NERR_GroupNotFound | 由【GROUPNAME】参数指定的本地组不存在。 |
NERR_UserNotFound | 无法找到用户名。 |
也可以看看