NetUserGetInfo功能检索有关服务器上特定用户帐户的信息。
安全要求
成功执行NetUserGetInfo不需要特殊的组成员资格。这是LAN管理器的变化,它需要管理员或帐户操作员本地组的成员资格,以在0以上的信息级别调用此函数(用户自己的帐户除外,可以使用级别11)。
NET_API_STATUS NetUserGetInfo(
LPWSTR【服务器名称】, | |
LPWSTR【用户名】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【用户名】
指向包含要在其上返回信息的用户帐户名称的Unicode字符串。
【水平】
指定以下值之一来返回提供的信息级别。
值 | 含义 |
0 | 返回USER_INFO_0 【bufptr。ig】中指向的结构 |
1 | 返回【bufptr。ig】 【bufptr。ig】中指向的结构 |
2 | 返回USER_INFO_2 【bufptr。ig】中指向的结构 |
3 | 返回【bufptr。ig】 【bufptr。ig】中指向的结构 |
10 | 返回USER_INFO_10 【bufptr。ig】中指向的结构 |
11 | 返回USER_INFO_11 【bufptr。ig】中指向的结构 |
20 | 返回USER_INFO_20 【bufptr。ig】中指向的结构 |
【bufptrig】
指向存储有【水平】参数的数据的缓冲区的指针。返回的缓冲区应该使用NetApiBufferFree函数取消分配。
返回值
如果该函数成功,则返回NERR_SUCCESS。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
NERR_InvalidComputer | 计算机名无效。 |
NERR_UserNotFound | 无法找到用户名。 |
也可以看看
NetApiBufferFree, NetUserSetInfo, NetUserGetGroups, NetUserEnum