RasAdminConnectionHangupNotification

【勇芳软件工作室】汉化HomePreviousNext

[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的注册表项。

也可以看看

RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS