RasAdminReleaseIpAddress 回调函数
[RasAdminReleaseIpAddress 函数可用于 Windows NT 4.0,在后续版本中不可用。 请改用 MprAdminReleaseIpAddress。]
RasAdminReleaseIpAddress 函数是由第三方 RAS 服务器管理 DLL 导出的应用程序定义的函数。 RAS 调用此函数以通知 DLL 远程客户端已断开连接,应释放 IP 地址。
语法
void CALLBACK RasAdminReleaseIpAddress(
_In_ WCHAR *lpszUserName,
_In_ WCHAR *lpszPortName,
_In_ IPADDR *pipAddress
);
parameters
-
lpszUserName [in]
-
指定指向以 null 结尾的 Unicode 字符串的指针,该字符串指定以前使用 RasAdminGetIpAddressForUser 函数为其获取 IP 地址的远程用户的名称。
-
lpszPortName [in]
-
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定 lpszUserName 的用户所连接的端口的名称。
-
pipAddress [in]
-
指向 IPADDR 变量的指针,该变量指定在上一次调用 RasAdminGetIpAddressForUser 时为此用户返回的 IP 地址。
返回值
此函数没有扩展的错误信息;不调用 GetLastError。
备注
仅当应用程序在之前调用 lpszUserName 参数指定的 RasAdminGetIpAddressForUser 期间,在 bNotifyRelease 参数中返回 TRUE 时,RAS 服务器才会调用 RasAdminReleaseIpAddress 函数。
第三方 RAS 管理 DLL 的安装程序必须通过在注册表中的以下项下提供信息,将 DLL 注册到 RAS:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
若要注册 DLL,请在此键下设置以下值。
值名称 | 值数据 |
---|---|
DisplayName | 包含 DLL 的用户友好显示名称 的REG_SZ 字符串。 |
DLLPath | 包含 DLL 完整路径 的REG_SZ 字符串。 |
例如,来自名为 ProElectron, Inc. 的虚构公司的 RAS 管理 DLL 的注册表项可能是:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
DisplayName: REG_SZ : ProElectron RAS 管理员 DLLPath: REG_SZ : C:\nt\system32\ntwkadm.dll
RAS 管理 DLL 的安装程序还应提供删除/卸载功能。 如果用户删除 DLL,安装程序应删除 DLL 的注册表项。