ITSGAuthenticateUserSink::OnUserAuthenticationFailed-Methode (tsgauthenticationengine.h)
Benachrichtigt Remotedesktopgateway (RD-Gateway), dass das Authentifizierungs-Plug-In den Benutzer nicht authentifizieren konnte.
Syntax
HRESULT OnUserAuthenticationFailed(
[in] ULONG_PTR context,
[in] HRESULT genericErrorCode,
[in] HRESULT specificErrorCode
);
Parameter
[in] context
Ein Zeiger auf eine ULONG , die einen Wert enthält, der diese Verbindung identifiziert. Verwenden Sie den Wert, der von der AuthenticateUser-Methode übergeben wurde.
[in] genericErrorCode
Ein Windows-Fehlercode, der die Ursache des Authentifizierungsfehlers angibt.
[in] specificErrorCode
Dieser Parameter ist reserviert. Legen Sie diesen Parameter immer auf 0 fest.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie können diese Methode über Ihre Implementierung von AuthenticateUser aufrufen. Wenn die Authentifizierung mehr als eine Sekunde benötigt, empfehlen wir, einen separaten Thread zu starten, um die Authentifizierung durchzuführen.
Ein Beispiel, das die OnUserAuthenticationFailed-Methode verwendet, finden Sie im Beispiel für die pluggable Authentifizierung und Autorisierung des Remotedesktopgateways .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | tsgauthenticationengine.h |