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

Weitere Informationen

MprAdminReleaseIpv6AddressForUser

RAS-Verwaltungs-DLL

RAS-Verwaltungsfunktionen

Referenz zur Remotezugriffsdienstverwaltung