MprAdminGetIpv6AddressForUser 函数 (mprapi.h)
RAS 为需要 IPv6 地址的每个用户调用 一次 MprAdminGetIpv6AddressForUser 函数。 RAS 使用 RAS 为用户选择的 IPv6 地址调用函数。 实现此函数的第三方 DLL 可以将此地址更改为自己选择的地址之一。
语法
DWORD MprAdminGetIpv6AddressForUser(
[in] WCHAR *lpwszUserName,
[in] WCHAR *lpwszPortName,
[in, out] IN6_ADDR *lpdwIpv6Address,
[out] BOOL *bNotifyRelease
);
parameters
[in] lpwszUserName
指向 Unicode 字符串的指针,该字符串指定需要 IP 地址的用户的名称。
[in] lpwszPortName
指向 Unicode 字符串的指针,该字符串指定用户尝试连接的端口的名称。
[in, out] lpdwIpv6Address
指向包含零或为用户分配的 IPv6 地址 RAS 的 in6_addr 结构的指针。
目前仅支持 64 位标识符。
在输出中,如果 RAS 指定零,DLL 会为用户分配 IPv6 地址。 在这种情况下,如果 DLL 未分配 IPv6 地址,则用户无法连接。 如果 RAS 指定了 IPv6 地址,DLL 要么接受该地址,要么替换其他地址。
[out] bNotifyRelease
指向 BOOL 变量的指针。 如果 DLL 将此变量设置为 TRUE,则当用户断开连接时,RAS 将调用 MprAdminReleaseIpv6AddressForUser 。 否则,当释放此 IP 地址时,RAS 不会通知 DLL。
返回值
如果函数成功,应NO_ERROR返回值。
如果函数返回除 NO_ERROR 以外的任何内容,则 RAS 将终止连接。
注解
管理 DLL 不需要实现 MprAdminGetIpv6AddressForUser 函数。 但是,如果 DLL 实现 MprAdminGetIpv6AddressForUser,则它还必须实现 MprAdminReleaseIpv6AddressForUser。
要求
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | mprapi.h |