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
);
參數
[in] lpwszUserName
Unicode 字串的指標,指定需要 IP 位址的使用者名稱。
[in] lpwszPortName
Unicode 字串的指標,指定使用者嘗試連接之埠的名稱。
[in, out] lpdwIpv6Address
in6_addr結構的指標,其中包含為使用者配置的零或 IPv6 位址 RAS。
目前僅支援 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 |