使用注意事项

连接配置字符串特定于实现。主机访问类库的不同实现可能要求在配置字符串中具有不同的格式或信息。此调用本质上是异步的；当此调用返回时，可能尚未启动新连接。应用程序可以使用 RegisterStartEvent 函数在连接启动时收到通知。

对于 Z and I Emulator for Windows，配置字符串有以下格式：

PROFILE=[\"]<filename>[\"] [CONNNAME=<c>] [WINSTATE=<MAX|MIN|RESTORE|HIDE>]

可选参数用方括号 [] 括起。参数间至少用一个空格分隔。参数可以是大写、小写或大小写混合，并且可以按任意顺序显示。每个参数的含义如下所示：

PROFILE=<filename>

命名包含连接配置信息的 Z and I Emulator for Windows 工作站概要文件（.WS 文件）。此参数不是可选的；必须提供概要文件名称。如果文件名中包含空格，则必须用双引号将名称引起来。<filename> 值可以是不带扩展名的概要文件名，带 .WS 扩展名的概要文件名，或全限定概要文件名路径。

CONNNAME=<c>

指定新连接的连接名称（EHLLAPI 短会话标识）。此值必须是单个字母字符（A-Z 或 a-z）。如果未指定此值，则将自动分配下一个可用的连接名称。如果指定名称的连接已存在，则会抛出错误 (ERRMAJ_INVALID_SESSION)。

WINSTATE=<MAX|MIN|RESTORE|HIDE>

指定仿真器窗口的初始状态。如果未指定此参数，则缺省值为 RESTORE。