[New - Windows NT]
RasAdminGetIpAddressForUser函数是由第三方RAS服务器管理DLL导出的应用程序定义函数。RAS调用此函数获取已拨入远程客户端的IP地址。
DWORD RasAdminGetIpAddressForUser
| WCHAR *【lpszUserName】, | //指向远程用户的名称 |
| WCHAR *【lpszPortName】, | //指向端口名称的指针 |
| IPADDR *【pipAddress】, | //指向IP地址的指针 |
| BOOL *【bNotifyRelease】 | //表示RAS是否应该调用RasAdminReleaseIpAddress |
| ); |
参数
【lpszUserName】
指向一个空值终止的Unicode字符串，其中包含需要IP地址的远程用户的名称。
【lpszPortName】
指向以null终止的Unicode字符串的指针，其中包含由【lpszUserName】指定的用户尝试连接的端口的名称。
【pipAddress】
指向IPADDR变量。在输入上，* 【pipAddress】包含零或RAS服务器建议用于拨入远程客户端的IP地址。该函数可以将* 【pipAddress】设置为不同的IP地址，或者接受传入的IP地址。如果* 【pipAddress】输入为零，则该函数必须提供IP地址;否则，客户端将无法使用IP连接到此服务器。
【bNotifyRelease】
指向BOOL变量。如果您希望RAS在用户从此端口断开连接时调用RasAdminReleaseIpAddress功能，请将此变量设置为TRUE否则将其设置为FALSE。
返回值
如果【pipAddress】指向客户端可以用于连接到此RAS服务器的IP地址，则该函数应返回NO_ERROR。如果该函数接受RAS服务器传递的IP地址，或该函数提供不同的IP地址，则可能会发生这种情况。
如果【pipAddress】未指向IP地址，则该函数应返回非零错误代码。如果没有IP地址可用，或者传入的IP地址是不可接受的，则可能会发生这种情况。在这种情况下，客户端将无法使用IP连接到此服务器。
备注
第三方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的注册表项。
也可以看看
