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

另请参阅

MprAdminReleaseIpv6AddressForUser

RAS 管理 DLL

RAS 管理功能

远程访问服务管理参考