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

Weitere Informationen

ITSGAuthenticationEngine