NetGroupSetInfo功能设置全局组帐户的参数。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetGroupSetInfo.
NET_API_STATUS NetGroupSetInfo(
LPWSTR服务器名称, | |
LPWSTRGROUPNAME, | |
DWORD水平, | |
LPBYTEBUF, | |
LPDWORDparm_err | |
); |
参数
服务器名称
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
GROUPNAME
指向包含要设置信息的全局组帐户名称的Unicode字符串。
水平
指定以下值之一来设置BUF参数中指向的信息级别。
值 | 含义 |
0 | 指定组名。指定的缓冲区指向GROUP_INFO_0结构的数组。 |
1 | 指定组名和评论。指定的缓冲区指向GROUP_INFO_1结构的数组。 |
2 | 指定有关组的信息。指定的缓冲区指向GROUP_INFO_2结构的数组。 |
1002 | 指定有关组的注释。指定的缓冲区指向GROUP_INFO_1002结构的数组。 |
1005 | 指定组属性。指定的缓冲区指向GROUP_INFO_1005结构的数组。 |
BUF
指向包含全局组信息的缓冲区。
parm_err
可选的指向DWORD的指针,返回ERROR_INVALID_PARAMETER消息后错误的第一个参数的索引。如果NULL,参数不会返回错误。
备注
您可以使用GROUP_INFO_1致电NetGroupSetInfo,并使用grpi1_name成员指定一个值。但是,该值将被忽略。使用GROUP_INFO_0调用NetGroupSetInfo并使用grpi0_name指定值来指定组名称的正确方法。
返回值
如果函数成功,返回值为NERR_Success。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_NotPrimary | 该操作只允许在域的主域控制器上。 |
NERR_GroupNotFound | 找不到组名。 |
NERR_SpeGroupOp | 指定的特殊组(用户组,管理员组,本地组或访客组)不允许操作。 |
也可以看看