ITSGAuthorizeConnectionSink::OnConnectionAuthorized-Methode (tsgpolicyengine.h)

Artikel
03/09/2024

Benachrichtigt Remotedesktopgateway (RD-Gateway) über das Ergebnis eines Versuchs, eine Verbindung zu autorisieren.

Syntax

HRESULT OnConnectionAuthorized(
  [in] HRESULT                     hrIn,
  [in] GUID                        mainSessionId,
  [in] ULONG                       cbSoHResponse,
  [in] BYTE                        *pbSoHResponse,
  [in] ULONG                       idleTimeout,
  [in] ULONG                       sessionTimeout,
  [in] SESSION_TIMEOUT_ACTION_TYPE sessionTimeoutAction,
  [in] AATrustClassID              trustClass,
  [in] PolicyAttributes            policyAttributes
);

Parameter

[in] hrIn

Das Ergebnis des Autorisierungsversuchs. Geben Sie S_OK an, um anzugeben, dass der Versuch erfolgreich war. Geben Sie einen anderen Wert an, um anzugeben, dass der Versuch fehlgeschlagen ist.

[in] mainSessionId

Ein eindeutiger Bezeichner, der der Verbindungsanforderung vom RD-Gateway zugewiesen ist.

[in] cbSoHResponse

Die Anzahl der Bytes, auf die vom pbSoHResponse-Parameter verwiesen wird.

[in] pbSoHResponse

Ein Zeiger auf ein BYTE , der die Antwort auf die Anforderung für eine Integritätsanweisung (Statement of Health, SoH) angibt. Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert.

[in] idleTimeout

Die Anzahl der Minuten, in denen die Verbindung im Leerlauf bleiben kann, bevor die Verbindung getrennt wird. Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert.

[in] sessionTimeout

Die maximale Anzahl von Minuten, die der Sitzung zugewiesen werden. Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert.

[in] sessionTimeoutAction

Die Aktion, die bei einem Sitzungstimeout ausgeführt werden soll. Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert. Dieser Parameter kann einen der folgenden Werte annehmen.

SESSION_TIMEOUT_ACTION_DISCONNECT

Trennen Sie die Sitzung.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Automatisches erneutes Authentifizieren und Erneutes Authentifizieren der Sitzung.

[in] trustClass

Dieser Parameter ist reserviert. Legen Sie sie immer auf AA_TRUSTEDUSER_TRUSTEDCLIENT fest. Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert.

[in] policyAttributes

Ein Array boolescher Werte, die die der Verbindung zugeordneten Umleitungseinstellungen angeben. Jedes Element des Arrays entspricht einem Wert der PolicyAttributeType-Enumeration . Wenn der hrIn-Parameter nicht S_OK ist, wird dieser Parameter ignoriert.

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 aus Ihrer Implementierung von AuthorizeConnection aufrufen. Wenn die Authentifizierung mehr als 1 Sekunde erfordert, wird empfohlen, einen separaten Thread zu starten, um die Authentifizierung durchzuführen.

Ein Beispiel, das die OnConnectionAuthorized-Methode verwendet, finden Sie im Beispiel für die austauschbare 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	tsgpolicyengine.h

Weitere Informationen

ITSGAuthorizeConnectionSink

Freigeben über