NetGroupGetInfo 函数 (lmaccess.h)
NetGroupGetInfo 函数检索有关安全数据库中特定全局组的信息,该组是安全帐户管理器 (SAM) 数据库,如果是域控制器,则为 Active Directory。
语法
NET_API_STATUS NET_API_FUNCTION NetGroupGetInfo(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[in] DWORD level,
[out] LPBYTE *bufptr
);
参数
[in] servername
指向常量字符串的指针,该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。
[in] groupname
指向常量字符串的指针,该常量字符串指定要为其检索信息的全局组的名称。 有关更多信息,请参见下面的“备注”部分。
[in] level
指定数据的信息级别。 此参数的取值可为下列值之一:
值 | 含义 |
---|---|
|
返回全局组名称。 bufptr 参数指向GROUP_INFO_0结构。 |
|
返回全局组名称和注释。 bufptr 参数指向GROUP_INFO_1结构。 |
|
返回有关全局组的详细信息。 bufptr 参数指向GROUP_INFO_2结构。 请注意,在 Windows XP 及更高版本上,建议改用 GROUP_INFO_3 。 |
|
返回有关全局组的详细信息。 bufptr 参数指向GROUP_INFO_3结构。
Windows 2000: 不支持此级别。 |
[out] bufptr
指向接收全局组信息结构的缓冲区地址的指针。 此数据的格式取决于 级别 参数的值。 系统为此缓冲区分配内存。 必须调用 NetApiBufferFree 函数才能解除分配内存。 有关详细信息,请参阅 网络管理功能缓冲区 和 网络管理功能缓冲区长度。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值可能是以下错误代码之一。
返回代码 | 说明 |
---|---|
|
用户无权访问请求的信息。 |
|
计算机名称无效。 |
|
找不到全局组名称。 |
注解
如果要对 Active Directory 进行编程,则可以调用某些 Active Directory 服务接口 (ADSI) 方法,以实现通过调用网络管理组函数可以实现的相同功能。 有关详细信息,请参阅 IADsGroup。
如果在运行 Active Directory 的域控制器上调用此函数,则会根据 安全对象的访问控制列表 (ACL) 允许或拒绝访问。 默认 ACL 允许所有经过身份验证的用户和“Pre-Windows 2000 兼容访问”组的成员查看信息。 如果在成员服务器或工作站上调用此函数,则所有经过身份验证的用户都可以查看信息。 有关这些平台上的匿名访问和限制匿名访问的信息,请参阅 网络管理功能的安全要求。 有关 ACL、ACE 和访问令牌的详细信息,请参阅访问控制模型。
Group 对象的安全描述符用于执行此函数的访问检查。
用户帐户名称限制为 20 个字符,组名称限制为 256 个字符。 此外,帐户名称不能以句点结尾,并且不能包含逗号或以下任何可打印字符:“、、/、、[、]、:、|、 <、、 >、+、=、;、?、*。 名称也不能包含 1-31 范围内的字符,这些字符不可打印。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmaccess.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |