NetUserGetGroups函数检索指定用户所属的全局组列表。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetUserGetGroups或启用了本地安全性的计算机,除非用户请求有关自己的帐户的详细信息。
NET_API_STATUS NetUserGetGroups(
LPWSTR【服务器名称】, | |
LPWSTR【用户名】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】, | |
DWORD【prefmaxlen】, | |
LPDWORD【entriesread】, | |
LPDWORD【为totalEntries】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定在本地计算机上运行的服务器程序。
【用户名】
指向包含要在每个组帐户中搜索的用户名称的Unicode字符串。
【水平】
指定以下值之一来返回提供的信息级别。
值 | 含义 |
0 | 【bufptrig】参数指向GROUP_USERS_INFO_0结构的数组。 |
1 | 【bufptrig】参数指向GROUP_USERS_INFO_1结构的数组。 |
【bufptrig】
指向存储有【水平】参数的数据的缓冲区的指针。传入的缓冲区必须先前已分配NetApiBufferAlloc.返回的缓冲区应使用NetApiBufferFree功能取消分配。
【prefmaxlen】
优选的最大长度,返回数据的8位字节。
【entriesread】
指向包含实际枚举元素数的DWORD的指针。
【为totalEntries】
指向DWORD的指针,其中包含可以从当前简历位置枚举的条目总数。
返回值
如果该函数成功,则返回NERR_SUCCESS。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_UserNotFound | 无法找到用户名。 |
备注
NetUserGetGroups函数返回一个GROUP_INFO_0结构的数组,它指定用户所属的所有组的名称。LAN Manager组与Windows NT系统组是分开的,不同。
也可以看看