返回参数
此函数会返回数据字符串和返回码。
- 数据字符串:
- 如果在位置 5(标准接口为 2)中指定 A(异步),并且功能已成功完成,则返回以下数据字符串:
| 字节 | 定义 | |
|---|---|---|
| 标准 | 增强 | |
| 9-10 | 13-14 | 2 字节功能请求标识。获取请求完成 (125) 功能使用它来确定此功能调用的完成情况。 |
| 15-16 | 保留。 | |
| 17-20 | EHLLAPI 返回事件对象地址的 4 字节值。应用程序可以等待此事件对象。清除事件对象后,应用程序必须发出获取请求完成 (125) 功能调用(仅限 32 位)。 | |
注: 每个成功的异步请求都将返回一个事件对象地址。不应再次使用事件对象。将为每个请求返回一个新的事件对象,该对象仅在该请求的持续时间内有效。
- 数据字符串:
- 如果在位置 5(16 位应用程序为 2)中指定“M”(异步消息方式),并且功能已成功完成,则返回以下数据字符串:
| 字节 | 定义 | |
|---|---|---|
| 9-10 | 13-14 | 2 字节功能请求标识。获取请求完成 (125) 功能使用它来确定此功能调用的完成情况。 |
| 15-16 | 保留。 | |
| 11-12 | 17-18 | 异步消息方式的任务标识。 |
| 19-20 | 保留。 | |
注: 如果该功能已成功完成,应用程序窗口将收到一条消息。消息是 RegisterWindowMessage (PCSHLL) 的返回值。wParam 参数包含功能调用返回的任务标识。lParam 参数的 HIWORD 包含返回码 0,表示功能已成功,lParam 参数的 LOWORD 包含功能编号 126。
- 返回码:
- 定义了以下代码:
| 返回码 | 说明 |
|---|---|
| 0 | 读取结构化字段功能已成功。 |
| 1 | 指定的主机表示空间短会话标识无效或未连接。 |
| 2 | 指定参数时出错。 |
| 9 | 发生了系统错误。 |
| 11 | 资源不可用(内存不可用)。 |
| 35 | 请求被拒绝。主机的出站传输已被取消。 |
| 36 | 请求被拒绝。与主机失去联系。 |
| 37 | 该功能已成功,但主机被禁用入站。 |