[New - Windows NT]
RasAdminConnectionHangupNotification函数是由第三方RAS服务器管理DLL导出的应用程序定义函数。当RAS断开现有连接时,它会调用此函数来通知您的DLL。
RAS服务器在多链路连接中为每个端口调用一次RasAdminConnectionHangupNotification.
VOID RasAdminConnectionHangupNotification(
RAS_PORT_1 *【pRasPort1】, | //指向连接信息的指针 |
RAS_PORT_STATISTICS *【pRasStats】, | //指向端口的统计信息 |
RAS_PARAMETERS *【pRasParams】 | //指向媒体特定参数和值的数组的指针 |
); |
参数
【pRasPort1】
指向RAS_PORT_1结构的指针,其中包含关于结束的连接的RAS数据。此结构包含可用于确定端口连接多长时间的相关连接信息。
【pRasStats】
指向包含端口统计信息的RAS_PORT_STATISTICS结构的指针。当连接首次建立时,RAS开始累积这些统计信息。
【pRasParams】
指向RAS_PARAMETERS结构的数组。每个结构都包含媒体专用密钥的名称,例如MAXCONNECTBPS及其关联值。
返回值
该函数不返回值。
备注
对RasAdminConnectionHangupNotification功能的RAS调用只是一个通知;您的DLL不需要任何操作。您可以使用此函数提供的信息用于会计目的。
第三方RAS管理DLL的安装程序必须通过在注册表中的以下密钥提供信息来向RAS注册DLL:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll
要注册该DLL,请在此键下设置以下值。
价值名称 | 价值数据 |
DisplayName | 包含DLL的用户友好显示名称的REG_SZ字符串。 |
DLLPath | 包含DLL完整路径的REG_SZ字符串。 |
例如,名为Netwerks Corporation的虚构公司的RAS管理DLL的注册表项可能是:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll
显示名称:REG_SZ:RAS管理DLL网络
DLLPath:REG_SZ:C:\\ nt \\ system32 \\ ntwkadm.dll
RAS管理DLL的安装程序还应提供删除/卸载功能。如果用户删除DLL,安装程序应该删除DLL的注册表项。
也可以看看