RasAdminReleaseIpAddress-Rückruffunktion

[Die RasAdminReleaseIpAddress-Funktion ist 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 die Verbindung des Remoteclients 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 Unicode-Zeichenfolge mit Null-Termin 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 Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Ports angibt, an dem der durch 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 RasAdminGetIpAddressForUser zurückgegeben wurde.

Rückgabewert

Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie getLastError nicht auf.

Bemerkungen

Der RAS-Server ruft die RasAdminReleaseIpAddress-Funktion nur auf, wenn die Anwendung true imbNotifyRelease-Parameter während des früheren Aufrufs von RasAdminGetIpAddressForUser für den durch den parameter lpszUserName 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 bereitgestellt werden:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

Um die DLL zu registrieren, legen Sie 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 ProElectron, Inc. kann beispielsweise wie folgt aussehen:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName: REG_SZ : ProElectron 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.