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
);

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