连接、句柄和名称

在 ECL 上下文中,连接是一个唯一的 Z and I Emulator for Windows 仿真器窗口。仿真器窗口可能实际连接到主机,也可能不连接,并且可能在屏幕上显示,也可能不显示。例如,Z and I Emulator for Windows 窗口可以处于已断开连接状态。连接通过其连接句柄或连接名称来区分。大多数 HACL 对象都与特定连接相关联。通常,对象在对象的构造函数上使用连接句柄或连接名称作为参数。对于不支持构造函数参数的 Visual Basic® 等语言,提供了成员函数来进行关联。构造后,对象就不能与任何其他连接相关联。例如,要创建与连接“B”关联的 ECLPS(表示空间)对象,将使用以下代码:

C++

ECLPS *PSObject;
PSObject = new ECLPS('B');

Visual Basic®

Dim PSObject as Object
Set PSObject = CreateObject("ZIEWin.autECLPS")
PSObject.SetConnectionByName("B")

HACL 连接名称是 A-Z 或 a-z 中的单个字符。最多可有 52 个连接名称,Z and I Emulator for Windows 当前限制为 52 个并发连接。连接的名称与其 EHLLAPI 短会话标识以及 Z and I Emulator for Windows 窗口标题和 OIA 上显示的会话标识相同。

HACL 句柄是代表单个连接的唯一 32 位数字。与连接名称不同,连接句柄不限于 52 个值,并且该值本身对应用程序没有意义。可以跨线程和进程使用连接句柄来引用相同的连接。

对于将来的扩展,应用程序应尽可能使用连接句柄。当需要标识连接时,大多数 HACL 对象接受句柄或名称。HACL 基类中有一些函数可用于将句柄转换为名称,以及将名称转换为句柄。这些函数可从任何 HACL 对象中使用。

注: 连接属性是动态属性。例如,如果将连接重新配置到其他主机,GetConnType 返回的连接类型可能会更改。通常,应用程序不应假定连接属性保持固定。