MprAdminGetIpAddressForUser 函数 (mprapi.h)
RAS 为需要 IP 地址的每个用户调用 一次 MprAdminGetIpAddressForUser 函数。 RAS 使用 RAS 为用户选择的 IP 地址调用 函数。 实现此函数的第三方 DLL 可以将此地址更改为其自己选择的地址之一。
语法
DWORD MprAdminGetIpAddressForUser(
[in] WCHAR *lpwszUserName,
[in] WCHAR *lpwszPortName,
[in, out] DWORD *lpdwIpAddress,
[out] BOOL *bNotifyRelease
);
parameters
[in] lpwszUserName
指向 Unicode 字符串的指针，该字符串指定需要 IP 地址的用户的名称。
[in] lpwszPortName
指向 Unicode 字符串的指针，该字符串指定用户尝试连接的端口的名称。
[in, out] lpdwIpAddress
输入时，指针指向包含零个或为用户分配的 IP 地址 RAS 的 DWORD 变量。
在输出中，如果 RAS 指定零，则 DLL 会为用户分配 IP 地址。 在这种情况下，如果 DLL 未分配 IP 地址，则用户将无法连接。 如果 RAS 指定了 IP 地址，则 DLL 要么接受该地址，要么替换其他地址。
[out] bNotifyRelease
指向 BOOL 变量的指针。 如果 DLL 将此变量设置为 TRUE，则当用户断开连接时，RAS 将调用 MprAdminReleaseIpAddress 。 否则，当释放此 IP 地址时，RAS 不会通知 DLL。
返回值
如果函数成功，应NO_ERROR返回值。
如果函数返回除 NO_ERROR 以外的任何内容，则 RAS 将终止连接。
注解
RAS 支持多个管理 DLL。 但是，RAS 仅在实现并导出它的第一个 DLL 中调用 MprAdminGetIpAddressForUser 。 RAS 忽略其他 DLL 中这些函数的实现。 RAS 按 在注册表中列出的顺序检查这些函数的 DLL。
管理 DLL 不需要实现 MprAdminGetIpAddressForUser 函数。 但是，如果 DLL 实现 MprAdminGetIpAddressForUser，它还必须实现 MprAdminReleaseIpAddress。
请勿从 MprAdminGetIpAddressForUser 内部调用任何 RAS 管理功能或 RAS 用户管理功能。 从标注函数内调用这些函数时，不会返回对这些函数的调用。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mprapi.h |