Metodo ITSGAuthorizeConnectionSink::OnConnectionAuthorized (tsgpolicyengine.h)

Articolo
03/03/2024

Notifica al gateway Desktop remoto (Gateway Desktop remoto) il risultato di un tentativo di autorizzare una connessione.

Sintassi

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
);

Parametri

[in] hrIn

Risultato del tentativo di autorizzazione. Specificare S_OK per indicare che il tentativo è riuscito. Specificare qualsiasi altro valore per indicare che il tentativo non è riuscito.

[in] mainSessionId

Identificatore univoco assegnato alla richiesta di connessione da Gateway Desktop remoto.

[in] cbSoHResponse

Numero di byte a cui fa riferimento il parametro pbSoHResponse .

[in] pbSoHResponse

Puntatore a un BYTE che specifica la risposta alla richiesta di un'istruzione di integrità (SoH). Se il parametro hrIn non è S_OK, questo parametro viene ignorato.

[in] idleTimeout

Numero di minuti che la connessione può rimanere inattiva prima di essere disconnessa. Se il parametro hrIn non è S_OK, questo parametro viene ignorato.

[in] sessionTimeout

Numero massimo di minuti assegnati alla sessione. Se il parametro hrIn non è S_OK, questo parametro viene ignorato.

[in] sessionTimeoutAction

Azione da eseguire al timeout della sessione. Se il parametro hrIn non è S_OK, questo parametro viene ignorato. Questo parametro può avere uno dei valori seguenti.

SESSION_TIMEOUT_ACTION_DISCONNECT

Disconnettere la sessione.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Ripetere automaticamente l'autenticazione e riautorizzare la sessione.

[in] trustClass

Questo parametro è riservato. Impostarlo sempre su AA_TRUSTEDUSER_TRUSTEDCLIENT. Se il parametro hrIn non è S_OK, questo parametro viene ignorato.

[in] policyAttributes

Matrice di valori booleani che specificano le impostazioni di reindirizzamento associate alla connessione. Ogni elemento della matrice corrisponde a un valore dell'enumerazione PolicyAttributeType . Se il parametro hrIn non è S_OK, questo parametro viene ignorato.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È possibile chiamare questo metodo dall'implementazione di AuthorizeConnection. Se l'autenticazione richiede più di 1 secondo, è consigliabile avviare un thread separato per eseguire l'autenticazione.

Per un esempio che usa il metodo OnConnectionAuthorized , vedere l'esempio di autenticazione pluggable e autorizzazione del gateway Desktop remoto .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	tsgpolicyengine.h

Vedi anche

ITSGAuthorizeConnectionSink

Condividi tramite