此函数会返回数据字符串和返回码。
- 数据字符串:
- 如果在位置 5 中指定了 A(通知的异步方式),并且已成功完成该功能,则返回以下数据字符串:
| 字节 |
定义 |
| 标准 |
增强 |
|
| 1 |
1 |
1 字符表示空间短名称 (PSID) |
| 2-8 |
保留。 |
| 9-12 |
EHLLAPI 返回事件对象地址的 4 字节值。应用程序可以等待此事件对象(仅限 32 位)。 |
- 数据字符串:
- 如果在位置 5(标准接口为 2)中指定 M(异步消息方式),并且功能已成功完成,则返回以下数据字符串:
| 字节 |
定义 |
| 标准 |
增强 |
|
| 1 |
1 |
1 字符表示空间短名称 (PSID) |
| 2-8 |
保留 |
| 3-4 |
9-10 |
异步消息方式的任务标识 |
注: 如果更新了 OIA 或表示空间,应用程序窗口将收到一条消息。消息是 RegisterWindowMessage (PCSHLL) 的返回值。wParam 参数包含功能调用返回的任务标识。lParam 的 HIWORD 包含返回码 21(显示 OIA 已更新)、22(显示主机表示空间已更新)或 23(显示 OIA 和主机表示空间已更新),lParam 参数的 LOWORD 包含功能编号 23。
- 返回码:
- 定义了以下代码:
| 返回码 |
定义 |
| 0 |
启动主机通知功能已成功。 |
| 1 |
指定的主机表示空间不正确。 |
| 2 |
指定参数时出错。 |
| 9 |
遇到系统错误。 |