子项和多链接连接

Windows NT Server 4.0 为支持多链接连接的电话簿子项提供支持。 多链接连接结合了多个连接的带宽，以提供具有更高带宽的单一连接。

RAS 电话簿条目可以包含零个或多个子项。 RasGetEntryProperties 函数检索 RASENTRY 结构，该结构包含有关电话簿条目的子项的信息。 dwSubEntriesRASENTRY 结构的成员表示子项数。 电话簿条目最初没有子项。 若要将子项添加到电话簿条目，请使用 RasSetSubEntryProperties 函数。

每个子项的属性包括电话号码和 TAPI 设备在拨号子项时要使用的名称和类型。 此外，如果 RAS 无法使用主号码建立连接，子实体可以包含要拨打的备用电话号码列表。 RasSetSubEntryProperties 和 RasGetSubEntryProperties 函数使用 RASSUBENTRY 结构来设置和检索指定电话簿子实体的属性。 子项由基于一个索引标识。

可以调用 RasSetEntryProperties 函数来配置多链接 RAS 条目，以在首次拨号时连接所有子项。 或者，可以将条目配置为提供可变带宽。 在这种情况下，RAS 最初连接单个子项，然后根据需要连接或断开连接其他子项。 对于可变带宽多链接连接，可以使用 RASDIALPARAMS 结构来指定在调用 RasDial 函数时要连接的初始子项。 使用 RasDialDlg 函数连接多链接条目时，可以使用 RASDIALDLG 结构来指定要连接的初始子项。

对于可变带宽多链接连接，请使用具有 RasSetEntryProperties 函数的 RASENTRY 结构来指定用于连接和断开各个子项的参数。 当使用的带宽超过指定间隔的可用带宽百分比时，RAS 会连接其他子项。

如果调用 RasDial 函数来建立多链接连接，则可以指定 RasDialFunc2 回调函数来接收有关连接的通知。 RasDialFunc2 类似于 RasDialFunc1 回调函数，只是它为多链接连接提供了其他信息，例如导致通知的子项的索引。 RAS 在连接或断开连接子项时调用 RasDialFunc2 函数。

可以使用 HRASCONN 连接句柄来挂起或检索有关多链接连接的信息。 可以为构成多链接的每个子连接以及组合的多链接连接获取连接句柄。 调用 RasDial 函数以建立多链接连接时，RasDial 将句柄返回到组合的多链接连接。 同样，RasEnumConnections 枚举连接时返回组合的多链接句柄。 若要获取多链接连接中某个子项连接的句柄，请调用 RasGetSubEntryHandle 函数。

可以使用 RasHangUp、RasGetConnectStatus和 RasGetProjectionInfo 函数中的组合多链接连接句柄和子连接句柄。 调用 RasHangUp 和合并的多链接句柄将终止整个连接;使用子项句柄调用它只会挂起该子项连接。 同样，RasGetConnectStatus 返回组合连接或单个连接的信息，具体取决于指定的句柄。 RasGetProjectionInfo 为多链接项 返回的投影信息对于每个子项的连接句柄都是相同的，因为它适用于主连接句柄。