Metodo ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)

Autentica un utente.

Gateway Desktop remoto chiama questo metodo quando riceve una nuova richiesta di connessione. Il plug-in di autenticazione deve autenticare l'utente in base al cookie a cui fa riferimento il parametro cookieData . Il plug-in di autenticazione deve quindi usare l'interfaccia ITSGAuthenticateUserSink per notificare al gateway Desktop remoto il risultato dell'autenticazione.

Sintassi

HRESULT AuthenticateUser(
  [in] GUID                     mainSessionId,
  [in] BYTE                     *cookieData,
  [in] ULONG                    numCookieBytes,
  [in] ULONG_PTR                context,
  [in] ITSGAuthenticateUserSink *pSink
);

Parametri

[in] mainSessionId

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

[in] cookieData

Puntatore a un BYTE che contiene il cookie fornito dall'utente.

[in] numCookieBytes

Numero di byte a cui fa riferimento il parametro cookieData .

[in] context

Puntatore a un ULONG che contiene un valore specifico per questa connessione. Questo valore deve essere passato di nuovo al gateway Desktop remoto usando i metodi dell'interfaccia ITSGAuthenticateUserSink .

[in] pSink

Puntatore a un'interfaccia ITSGAuthenticateUserSink che il plug-in di autenticazione deve usare per notificare al gateway Desktop remoto il risultato dell'autenticazione.

Valore restituito

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

Commenti

Se questo metodo restituisce S_OK, Gateway Desktop remoto attende che il plug-in di autenticazione chiami un metodo dell'interfaccia ITSGAuthenticateUserSink . Se viene restituito un altro valore, Gateway Desktop remoto nega immediatamente la richiesta di connessione.

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

Requisiti

Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	tscationthenticationengine.h

Vedi anche

ITSGAuthenticationEngine