NetUserGetGroups

【勇芳软件工作室】汉化HomePreviousNext

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系统组是分开的,不同。

也可以看看

NetUserGetInfo