NetUserEnum功能提供有关服务器上所有用户帐户的信息。
安全要求
只有管??理员或帐户操作员本地组的成员才能在第1级和第2级成功执行NetUserEnum.在0级或10级不需要特殊的组成员资格。
NET_API_STATUS NetUserEnum（
| LPWSTR【服务器名称】, | |
| DWORD【水平】, | |
| DWORD【过滤】, | |
| LPBYTE【* bufptrig】, | |
| DWORD【prefmaxlen】, | |
| LPDWORD【entriesread】, | |
| LPDWORD【为totalEntries】, | |
| LPDWORD【resume_handle】 | |
| ); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【水平】
指定以下值之一来返回提供的信息级别。
| 值 | 含义 |
| 0 | 【bufptrig】参数指向USER_INFO_0结构的数组。 |
| 1 | 【bufptrig】参数指向USER_INFO_1结构的数组。 |
| 2 | 【bufptrig】参数指向USER_INFO_2结构的数组。 |
| 3 | 【bufptrig】参数指向USER_INFO_3结构的数组。 |
| 10 | 【bufptrig】参数指向USER_INFO_10结构的数组。 |
| 11 | 【bufptrig】参数指向USER_INFO_11结构的数组。 |
| 12 | 【bufptrig】参数指向USER_INFO_20结构的数组。 |
【过滤】
指定要枚举的帐户类型的过滤器。值为零表示所有帐户类型。允许值为：
| 值 | 含义 |
| FILTER_TEMP_DUPLICATE_ACCOUNTS | 枚举域控制器上的本地用户帐户数据。 |
| FILTER_NORMAL_ACCOUNT | 枚举计算机上的全局用户帐户数据。 |
| FILTER_INTERDOMAIN_TRUST_ACCOUNT | 枚举域控制器上的域信任帐户数据。 |
| FILTER_WORKSTATION_TRUST_ACCOUNT | 枚举域控制器上的工作站或成员服务器帐户数据。 |
| FILTER_SERVER_TRUST_ACCOUNT | 枚举域控制器上的域控制器帐户数据。 |
【bufptrig】
指向存储有【水平】参数的数据的缓冲区的指针。返回的缓冲区应该使用NetApiBufferFree函数取消分配。
【prefmaxlen】
优选的最大长度，返回数据的8位字节。
【entriesread】
指向包含实际枚举元素数的DWORD的指针。
【为totalEntries】
指向DWORD的指针，其中包含可以从当前恢复位置枚举的条目的总数。例外：如果呼叫是运行LAN Manager 2的计算机。【x】，【为totalEntries】参数将始终反映数据库中的条目总数，无论它在恢复序列中的位置。
【resume_handle】
指向DWORD的DWORD，其中包含【resume_handle】，用于继续现有的用户搜索。句柄在第一个通话时应为零，对于后续调用保持不变。如果【resume_handle】为NULL，则不存储恢复句柄。
返回值
如果该函数成功，则返回NERR_SUCCESS。
如果函数失败，则返回值是以下错误代码之一。
| 值 | 含义 |
| ERROR_ACCESS_DENIED | 用户无权访问所请求的信息。 |
| NERR_InvalidComputer | 计算机名无效。 |
| ERROR_MORE_DATA | 更多条目可用于后续呼叫。 |
备注
NetUserEnum函数返回完整的USER_INFO_0或USER_INFO_1组件。如果level设置为1，则每个数据结构的密码组件将被设置为NULL，以保持密码的安全性。NetUserEnum不返回所有Windows NT系统用户。它只返回由NetUserAdd功能添加的用户。
也可以看看
NetUserGetGroups, NetUserGetInfo, USER_INFO_0, USER_INFO_1, NetUserAdd
