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.