NetGroupGetInfo功能检索有关服务器上特定全局组帐户的信息。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetGroupGetInfo.
NET_API_STATUS NetGroupGetInfo(
LPWSTR【服务器名称】, | |
LPWSTR【GROUPNAME】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【GROUPNAME】
指向包含要在其上返回信息的全局组帐户的名称的Unicode字符串。
【水平】
指定以下值之一以返回【bufptrig】参数中指向的信息级别。
值 | 含义 |
0 | 返回组名。返回的缓冲区指向GROUP_INFO_0结构的数组。 |
1 | 返回组名和评论。返回的缓冲区指向GROUP_INFO_1结构的数组。 |
2 | 返回有关组的信息。返回的缓冲区指向GROUP_INFO_2结构的数组。 |
【bufptrig】
指向返回信息结构的指针返回到【bufptrig】指向的地址中。返回的缓冲区应使用NetApiBufferFree取消分配。
返回值
如果函数成功,返回值为NERR_Success。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_GroupNotFound | 找不到组名。 |
也可以看看