MprAdminGetIpv6AddressForUser-Funktion (mprapi.h)
RAS ruft die Funktion MprAdminGetIpv6AddressForUser einmal für jeden Benutzer auf, der eine IPv6-Adresse erfordert. RAS ruft die Funktion mit der IPv6-Adresse auf, die RAS für den Benutzer auswählt. Die DRITTANBIETER-DLL, die diese Funktion implementiert, kann diese Adresse in eine ihrer eigenen Wahl ändern.
Syntax
DWORD MprAdminGetIpv6AddressForUser(
[in] WCHAR *lpwszUserName,
[in] WCHAR *lpwszPortName,
[in, out] IN6_ADDR *lpdwIpv6Address,
[out] BOOL *bNotifyRelease
);
Parameter
[in] lpwszUserName
Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Benutzers angibt, der eine IP-Adresse erfordert.
[in] lpwszPortName
Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Ports angibt, an dem der Benutzer versucht, eine Verbindung herzustellen.
[in, out] lpdwIpv6Address
Zeiger auf eine in6_addr-Struktur , die null oder die dem Benutzer zugewiesene IPv6-Adresse enthält.
Derzeit werden nur 64-Bit-Bezeichner unterstützt.
Wenn RAS null angegeben hat, weist die DLL bei der Ausgabe dem Benutzer eine IPv6-Adresse zu. Wenn die DLL in diesem Fall keine IPv6-Adresse zuweist, kann der Benutzer keine Verbindung herstellen. Wenn RAS eine IPv6-Adresse angegeben hat, akzeptiert die DLL entweder die Adresse oder ersetzt eine andere Adresse.
[out] bNotifyRelease
Zeiger auf eine BOOL-Variable . Wenn die DLL diese Variable auf TRUE festlegt, ruft RAS MprAdminReleaseIpv6AddressForUser auf, wenn der Benutzer die Verbindung trennt. Andernfalls benachrichtigt RAS die DLL nicht, wenn diese IP-Adresse freigegeben wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, sollte der Rückgabewert NO_ERROR werden.
Wenn die Funktion etwas anderes als NO_ERROR zurückgibt, beendet RAS die Verbindung.
Hinweise
Eine Verwaltungs-DLL muss die Funktion MprAdminGetIpv6AddressForUser nicht implementieren. Wenn die DLL jedoch MprAdminGetIpv6AddressForUser implementiert, muss sie auch MprAdminReleaseIpv6AddressForUser implementieren.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mprapi.h |