MprAdminGetIpAddressForUser-Funktion (mprapi.h)

RAS ruft die MprAdminGetIpAddressForUser-Funktion einmal für jeden Benutzer auf, der eine IP-Adresse erfordert. RAS ruft die Funktion mit der IP-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 MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [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] lpdwIpAddress

Zeigen Sie bei der Eingabe auf eine DWORD-Variable , die null oder die dem Benutzer zugewiesene IP-Adresse RAS enthält.

Wenn RAS null angegeben hat, weist die DLL bei der Ausgabe eine IP-Adresse für den Benutzer zu. Wenn die DLL in diesem Fall keine IP-Adresse zuweist, kann der Benutzer keine Verbindung herstellen. Wenn RAS eine IP-Adresse angegeben hat, akzeptiert die DLL entweder die Adresse oder ersetzt eine andere.

[out] bNotifyRelease

Zeiger auf eine BOOL-Variable . Wenn die DLL diese Variable auf TRUE festlegt, ruft RAS MprAdminReleaseIpAddress 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

RAS unterstützt mehrere Verwaltungs-DLLs. Ras ruft MprAdminGetIpAddressForUser jedoch nur in der ersten DLL auf, die es implementiert und exportiert. RAS ignoriert Implementierungen dieser Funktionen in den anderen DLLs. RAS überprüft die DLLs für diese Funktionen in der Reihenfolge, in der sie in der Registrierung aufgeführt sind.

Eine Verwaltungs-DLL muss die Funktion MprAdminGetIpAddressForUser nicht implementieren. Wenn die DLL jedoch MprAdminGetIpAddressForUser implementiert, muss sie auch MprAdminReleaseIpAddress implementieren.

Rufen Sie keine der RAS-Verwaltungsfunktionen oder RAS-Benutzerverwaltungsfunktionen aus MprAdminGetIpAddressForUser auf. Aufrufe dieser Funktionen werden nicht zurückgegeben, wenn sie in einer Legendenfunktion ausgeführt werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h

Weitere Informationen

MprAdminReleaseIpAddress

RAS-Verwaltungs-DLL

RAS-Verwaltungsfunktionen

Remotezugriffsdienst-Verwaltungsreferenz