NetSessionEnum功能提供有关所有当前会话的信息。
安全要求
只有管??理员或帐户操作员本地组的成员才能在1级或2级成功执行NetSessionEnum.0级或10级呼叫不需要特殊的组成员资格。
NET_API_STATUS NetSessionEnum(
LPTSTR【服务器名称】, | |
LPTSTR【UncClientName】, | |
LPTSTR【用户名】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】, | |
DWORD【prefmaxlen】, | |
LPDWORD【entriesread】, | |
LPDWORD【为totalEntries】, | |
LPDWORD【resume_handle】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【UncClientName】
指向包含要返回信息的计算机会话名称的Unicode字符串。NULL指针或字符串指定要对服务器上的所有计算机会话进行枚举。
【用户名】
指向一个Unicode字符串,其中包含用于枚举会话的用户的名称。NULL指针或字符串指定要枚举所有用户的会话。
【水平】
指定以下值之一来返回提供的信息级别。
值 | 含义 |
0 | 【bufptrig】参数指向SESSION_INFO_0结构的数组。 |
1 | 【bufptrig】参数指向SESSION_INFO_1结构的数组。 |
2 | 【bufptrig】参数指向SESSION_INFO_2结构的数组。 |
10 | 【bufptrig】参数指向SESSION_INFO_10结构的数组。 |
502 | 【bufptrig】参数指向SESSION_INFO_502结构的数组。 |
【bufptrig】
指向存储有【水平】参数的数据的缓冲区的指针。
【prefmaxlen】
优选的最大长度,返回数据的8位字节。
【entriesread】
指向包含实际枚举元素数的DWORD的指针。
【为totalEntries】
指向DWORD的指针,其中包含可以从当前简历位置枚举的条目总数。
【resume_handle】
指向DWORD的DWORD,其中包含【resume_handle】,用于继续现有的会话搜索。句柄在第一个通话时应为零,对于后续调用保持不变。如果【resume_handle】为NULL,则不存储恢复句柄。
也可以看看
NetSessionGetInfo, SESSION_INFO_0, SESSION_INFO_1, SESSION_INFO_2, SESSION_INFO_10, SESSION_INFO_502