Windows NT版本4.0提供支持电话簿子条目,启用多链接连接。多链路连接组合多个连接的带宽,以提供具有更高带宽的单个连接。
RAS电话簿条目可以有零个或多个子条目。RasGetEntryProperties函数检索包含有关电话簿条目的子条目的信息的RASENTRY结构。RASENTRY结构的dwSubEntries成员表示子条目数。电话簿条目最初没有子条目。要将子条目添加到电话簿条目,请使用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为多链接条目返回的投影信息对于每个子连接句柄与主连接句柄相同。