NetLocalGroupGetInfo 函数 (lmaccess.h)

项目
08/24/2023

NetLocalGroupGetInfo 函数检索有关服务器上特定本地组帐户的信息。

语法

NET_API_STATUS NET_API_FUNCTION NetLocalGroupGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

parameters

[in] servername

指向常量字符串的指针，该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。如果此参数为 NULL，则使用本地计算机。

[in] groupname

指向常量字符串的指针，该常量字符串指定要检索信息的本地组帐户的名称。有关更多信息，请参见下面的“备注”部分。

[in] level

指定数据的信息级别。此参数可以是以下值。

值	含义
1	返回与本地组关联的注释。 bufptr 参数指向LOCALGROUP_INFO_1结构。

[out] bufptr

指向接收返回信息结构的缓冲区地址的指针。此缓冲区由系统分配，必须使用 NetApiBufferFree 函数释放。有关详细信息，请参阅网络管理功能缓冲区和网络管理功能缓冲区长度。

返回值

如果函数成功，则返回值NERR_Success。

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

返回代码	说明
ERROR_ACCESS_DENIED	用户无权访问请求的信息。
NERR_InvalidComputer	计算机名称无效。
NERR_GroupNotFound	指定的本地组不存在。

注解

如果在运行 Active Directory 的域控制器上调用此函数，则会根据安全对象的访问控制列表 (ACL) 允许或拒绝访问。默认 ACL 允许所有经过身份验证的用户和“Pre-Windows 2000 兼容访问”组的成员查看信息。如果在成员服务器或工作站上调用此函数，则所有经过身份验证的用户都可以查看信息。有关这些平台上的匿名访问和限制匿名访问的信息，请参阅网络管理功能的安全要求。有关 ACL、ACE 和访问令牌的详细信息，请参阅访问控制模型。

LocalGroup 对象的安全描述符用于执行此函数的访问检查。

用户帐户名称限制为 20 个字符，组名称限制为 256 个字符。此外，帐户名称不能以句点结尾，并且不能包含逗号或以下任何可打印字符：“、、/、、[、]、：、|、 <、、 >、+、=、;、？、*。名称也不能包含 1-31 范围内的字符，这些字符不可打印。

如果要对 Active Directory 进行编程，则可以调用某些 Active Directory 服务接口 (ADSI) 方法，以实现通过调用网络管理本地组函数可以实现的相同功能。有关详细信息，请参阅 IADsGroup。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	lmaccess.h (包括 Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll