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