NetLocalGroupGetMembers函数检索安全数据库中特定本地组成员的列表。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetLocalGroupGetMembers.但是,当请求由具有指定本地组的成员资格的用户进行时,不需要特殊的组成员资格。
NET_API_STATUS NetLocalGroupGetMembers(
LPWSTR【服务器名称】, | |
LPWSTR【localgroupname】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】, | |
DWORD【prefmaxlen】, | |
LPDWORD【entriesread】, | |
LPDWORD【为totalEntries】, | |
LPDWORD【{999796001}min{999796002}】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【localgroupname】
指向包含要列出其成员的本地组的名称的Unicode字符串。
【水平】
指定以下值之一来返回提供的信息级别。
值 | 含义 |
0 | 【bufptrig】参数指向LOCALGROUP_MEMBERS_INFO_0结构的数组。 |
1 | 【bufptrig】参数指向LOCALGROUP_MEMBERS_INFO_1结构的数组。 |
2 | 【bufptrig】参数指向LOCALGROUP_MEMBERS_INFO_2结构的数组。 |
3 | 【bufptrig】参数指向LOCALGROUP_MEMBERS_INFO_3结构的数组。 |
【bufptrig】
返回时,返回信息结构的指针在【bufptrig】指向的地址中返回。【】返回的缓冲区应使用NetApiBufferFree 功能取消分配。
【prefmaxlen】
优选的最大长度,返回数据的8位字节。
【entriesread】
指向包含实际枚举元素数的DWORD的指针。
【为totalEntries】
指向DWORD的指针,其中包含可以从当前恢复位置枚举的条目的总数。
指向DWORD,其中包含用于继续现有用户组搜索的【resumehandle,】.句柄在第一个通话时应为零,对于后续调用保持不变。如果【{999796001}min{999796002}】为NULL,则不存储恢复句柄。
返回值
如果函数成功,返回值为NERR_Success。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
ERROR_NO_SUCH_ALIAS | 别名组不存在。 |
也可以看看