ITSGAuthenticationEngine::AuthenticateUser-Methode (tsgauthenticationengine.h)
Authentifiziert einen Benutzer.
Remotedesktopgateway (RD-Gateway) ruft diese Methode auf, wenn eine neue Verbindungsanforderung empfangen wird. Das Authentifizierungs-Plug-In sollte den Benutzer basierend auf dem Cookie authentifizieren, auf das durch den cookieData-Parameter verwiesen wird. Das Authentifizierungs-Plug-In sollte dann die ITSGAuthenticateUserSink-Schnittstelle verwenden, um das RD-Gateway über das Ergebnis der Authentifizierung zu benachrichtigen.
Syntax
HRESULT AuthenticateUser(
[in] GUID mainSessionId,
[in] BYTE *cookieData,
[in] ULONG numCookieBytes,
[in] ULONG_PTR context,
[in] ITSGAuthenticateUserSink *pSink
);
Parameter
[in] mainSessionId
Ein eindeutiger Bezeichner, der der Verbindungsanforderung vom RD-Gateway zugewiesen ist.
[in] cookieData
Ein Zeiger auf ein BYTE , das das vom Benutzer bereitgestellte Cookie enthält.
[in] numCookieBytes
Die Anzahl der Bytes, auf die vom cookieData-Parameter verwiesen wird.
[in] context
Ein Zeiger auf eine ULONG , die einen für diese Verbindung spezifischen Wert enthält. Dieser Wert sollte mithilfe der Methoden der ITSGAuthenticateUserSink-Schnittstelle an das RD-Gateway zurückgegeben werden.
[in] pSink
Ein Zeiger auf eine ITSGAuthenticateUserSink-Schnittstelle , die das Authentifizierungs-Plug-In verwenden muss, um das RD-Gateway über das Ergebnis der Authentifizierung zu benachrichtigen.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn diese Methode S_OK zurückgibt, wartet das RD-Gateway darauf, dass das Authentifizierungs-Plug-In eine Methode der ITSGAuthenticateUserSink-Schnittstelle aufruft. Wenn ein anderer Wert zurückgegeben wird, verweigert das RD-Gateway sofort die Verbindungsanforderung.
Ein Beispiel, das die AuthenticateUser-Methode verwendet, finden Sie im Beispiel für die austauschbare Authentifizierung und Autorisierung des Remotedesktopgateways .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | tsgauthenticationengine.h |