RasSecurityDialogEnd-Funktion (rasshost.h)
Die RasSecurityDialogEnd-Funktion ist ein RAS-Sicherheits-DLL-Einstiegspunkt eines Drittanbieters, den der RAS-Server aufruft, um eine Authentifizierungstransaktion zu beenden.
Syntax
DWORD RasSecurityDialogEnd(
[in] HPORT hPort
);
Parameter
[in] hPort
Gibt das Porthandle an, das der RAS-Server im RasSecurityDialogBegin-Aufruf für diese Authentifizierungstransaktion an die Sicherheits-DLL übergeben hat.
Rückgabewert
Wenn die Sicherheits-DLL NO_ERROR zurückgibt, beendet der RAS-Server die Authentifizierungstransaktion nicht. In diesem Fall muss die Sicherheits-DLL später die RasSecurityDialogComplete-Funktion aufrufen, wenn sie beendet werden kann.
Wenn die Sicherheits-DLL einen Fehlercode ungleich null zurückgibt, beendet der RAS-Server die Authentifizierungstransaktion. In diesem Fall muss die Sicherheits-DLL keinen weiteren RasSecurityDialogComplete-Aufruf ausführen. Gibt einen in Winerror.h oder Raserror.h definierten Fehlercode zurück, z. B. ERROR_PORT_DISCONNECTED.
Hinweise
Wenn eine Sicherheits-DLL die Authentifizierung des Remotebenutzers abgeschlossen hat, wird die RasSecurityDialogComplete-Funktion aufgerufen. Der RAS-Server führt dann eine Bereinigungssequenz aus, die einen Aufruf der RasSecurityDialogEnd-Funktion der DLL enthält. Dies gibt der Sicherheits-DLL die Möglichkeit, alle erforderlichen Bereinigungen durchzuführen. Um die Authentifizierungstransaktion zu beenden, muss RasSecurityDialogEnd einen Fehlercode ungleich null zurückgeben.
Der RAS-Server kann auch RasSecurityDialogEnd aufrufen, wenn er die Authentifizierungstransaktion ungewöhnlich beenden muss, bevor die Sicherheits-DLL RasSecurityDialogComplete aufruft. In diesem Fall sollte die Sicherheits-DLL den Workerthread beenden, der dem hPort-Porthandle zugeordnet ist, und alle anderen erforderlichen Bereinigungen durchführen. Wenn RasSecurityDialogEnd einen Wert ungleich null zurückgibt, muss die Sicherheits-DLL rasSecurityDialogComplete nicht aufrufen.
Sowohl für die normale als auch für die ungewöhnliche Beendigung gibt die RasSecurityDialogEnd-Funktion NO_ERROR zurück, um die Beendigung zu verzögern. Wenn dies der Fall ist, muss rasSecurityDialogComplete später aufgerufen werden, wenn er zum Beenden bereit ist.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | rasshost.h |