Rückruffunktion "RasAdminReleaseIpAddress"
[Die RasAdminReleaseIpAddress-Funktion ist für die Verwendung in Windows NT 4.0 verfügbar und in nachfolgenden Versionen nicht verfügbar. Verwenden Sie stattdessen MprAdminReleaseIpAddress.]
Die RasAdminReleaseIpAddress-Funktion ist eine anwendungsdefinierte Funktion, die von einer RAS-Serververwaltungs-DLL eines Drittanbieters exportiert wird. RAS ruft diese Funktion auf, um die DLL zu benachrichtigen, dass der Remoteclient getrennt wurde und dass die IP-Adresse freigegeben werden soll.
Syntax
void CALLBACK RasAdminReleaseIpAddress(
_In_ WCHAR *lpszUserName,
_In_ WCHAR *lpszPortName,
_In_ IPADDR *pipAddress
);
Parameter
-
lpszUserName [ In]
-
Gibt den Zeiger auf eine auf NULL endende Unicode-Zeichenfolge an, die den Namen eines Remotebenutzers angibt, für den zuvor mithilfe der RasAdminGetIpAddressForUser-Funktion eine IP-Adresse abgerufen wurde.
-
lpszPortName [ In]
-
Zeiger auf eine auf NULL endende Unicode-Zeichenfolge, die den Namen des Ports angibt, an dem der von lpszUserName angegebene Benutzer verbunden ist.
-
pipAddress [ In]
-
Zeiger auf eine IPADDR-Variable, die die IP-Adresse angibt, die für diesen Benutzer in einem vorherigen Aufruf von RasAdminGetIpAddressForUserzurückgegeben wurde.
Rückgabewert
Für diese Funktion sind keine erweiterten Fehlerinformationen vorhanden. Rufen Sie getLastErrornicht auf.
Bemerkungen
Der RAS-Server ruft die RasAdminReleaseIpAddress-Funktion nur auf, wenn die Anwendung true im bNotifyRelease-Parameter während des vorherigen Aufrufs von RasAdminGetIpAddressForUser für den vom lpszUserName-Parameter angegebenen Benutzer zurückgegeben hat.
Das Setupprogramm für eine RAS-Verwaltungs-DLL eines Drittanbieters muss die DLL bei RAS registrieren, indem Informationen unter dem folgenden Schlüssel in der Registrierung zur Verfügung gestellt werden:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
Legen Sie zum Registrieren der DLL die folgenden Werte unter diesem Schlüssel fest.
| Wertname | Wertdaten |
|---|---|
| DisplayName | Eine REG _ SZ-Zeichenfolge, die den benutzerfreundlichen Anzeigenamen der DLL enthält. |
| DLLPath | Eine REG _ SZ-Zeichenfolge, die den vollständigen Pfad der DLL enthält. |
Der Registrierungseintrag für eine RAS-Verwaltungs-DLL eines fiktiven Unternehmens mit dem Namen ProElecron, Inc. kann beispielsweise wie im Folgenden beschrieben sein:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
DisplayName: REG _ SZ : ProElecron RAS Admin DLL DLLPath: REG _ SZ : C: \ nt \ system32 \ntwkadm.dll
Das Setupprogramm für eine RAS-Verwaltungs-DLL sollte auch Funktionen zum Entfernen/Deinstallieren bereitstellen. Wenn ein Benutzer die DLL entfernt, sollte das Setupprogramm die Registrierungseinträge der DLL löschen.