NetUserGetLocalGroups

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

NetUserGetLocalGroups函数检索指定用户所属的本地组列表。

安全要求

只有管??理员或帐户操作员本地组的成员才能成功执行NetUserGetLocalGroups.

NET_API_STATUS NetUserGetLocalGroups(

LPWSTR【服务器名称】, 
LPWSTR【用户名】, 
DWORD【水平】, 
DWORD【旗】, 
LPBYTE【* bufptrig】, 
DWORD【prefmaxlen】, 
LPDWORD【entriesread】, 
LPDWORD【为totalEntries】 
); 

参数

【服务器名称】

指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。

【用户名】

指向包含用于返回全局组成员身份的用户名称的Unicode字符串。此参数可以是< UserName >的形式,在这种情况下,【用户名】预期在【服务器名称】上找到。用户名也可以是< DomainName > \\ < UserName >,在这种情况下< DomainName >与【服务器名称】和< UserName >相关联被发现在该领域。

【水平】

所需信息级别。只有0是有效的。

【旗】

位掩码的标志。目前,只定义了LG_INCLUDE_INDIRECT。如果该位置位,该函数还将返回用户间接成员的本地组(也就是说,通过在一个本身是一个或多个本地组的成员的全局组中)。

【bufptrig】

返回时,返回信息结构的指针返回到【bufptrig】指向的地址中。返回的信息是LOCALGROUP_USERS_INFO_0结构的数组。【】返回的缓冲区应使用NetApiBufferFree功能取消分配。

【prefmaxlen】

优选的最大长度,返回数据的8位字节。

【entriesread】

指向包含实际枚举元素数的DWORD.

【为totalEntries】

指向DWORD的指针,其中包含可能枚举的条目总数。

返回值

如果该函数成功,则返回NERR_SUCCESS。

如果函数失败,则返回值是以下错误代码之一。

含义
ERROR_ACCESS_DENIED用户无权访问所请求的信息。
NERR_InvalidComputer计算机名无效。
NERR_UserNotFound无法找到用户名。

也可以看看

NetApiBufferFree