返回参数
此函数会返回数据字符串、长度和返回码。
- 数据字符串:
- 返回的数据字符串长度为 16n 字节(标准接口为 12n ),其中 n 是主机会话数。描述符并置到数据字符串、每个会话类型,以及主机会话的表示空间大小。
每个 16 字节(标准接口为 12 字节)会话描述符的格式如下所示:
| 字节 | 定义 | |
|---|---|---|
| 标准 | 增强 | |
| 1 | 1 | 1 字符表示空间短名称 (PSID) |
| 2-4 | 保留 | |
| 2-9 | 5-12 | 会话长名称(与概要文件名相同;或者,如果未设置概要文件,则与短名称相同) |
| 10 | 13 | 连接类型 H=主机 |
| 14 | 保留 | |
| 11-12 | 15-16 | 主机表示空间大小(这是一个二进制数字,不是采用显示格式)。如果会话类型为打印会话,则值为 0。 |
- 长度:
- 已启动的主机会话数。
- 返回码:
- 定义了以下代码:
| 返回码 | 说明 |
|---|---|
| 0 | 查询会话功能已成功。 |
| 2 | 指定的字符串长度不正确。 |
| 9 | 遇到系统错误。 |