Método ITSGAuthorizeConnectionSink::OnConnectionAuthorized (tsgpolicyengine.h)

Notifica o Gateway de Área de Trabalho Remota (Gateway de Área de Trabalho Remota) sobre o resultado de uma tentativa de autorizar uma conexão.

Sintaxe

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

Parâmetros

[in] hrIn

O resultado da tentativa de autorização. Especifique S_OK para indicar que a tentativa foi bem-sucedida. Especifique qualquer outro valor para indicar que a tentativa falhou.

[in] mainSessionId

Um identificador exclusivo atribuído à solicitação de conexão pelo Gateway de Área de Trabalho Remota.

[in] cbSoHResponse

O número de bytes referenciados pelo parâmetro pbSoHResponse .

[in] pbSoHResponse

Um ponteiro para um BYTE que especifica a resposta à solicitação de uma declaração de integridade (SoH). Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado.

[in] idleTimeout

O número de minutos em que a conexão pode permanecer ociosa antes de ser desconectada. Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado.

[in] sessionTimeout

O número máximo de minutos alocados para a sessão. Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado.

[in] sessionTimeoutAction

A ação a ser executada quando a sessão atingir o tempo limite. Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado. Esse parâmetro pode usar um dos valores a seguir.

SESSION_TIMEOUT_ACTION_DISCONNECT

Desconecte a sessão.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Reautenticar silenciosamente e reautorizar a sessão.

[in] trustClass

Esse parâmetro é reservado. Sempre defina como AA_TRUSTEDUSER_TRUSTEDCLIENT. Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado.

[in] policyAttributes

Uma matriz de valores boolianos que especificam as configurações de redirecionamento associadas à conexão. Cada elemento da matriz corresponde a um valor da enumeração PolicyAttributeType . Se o parâmetro hrIn não for S_OK, esse parâmetro será ignorado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Você pode chamar esse método de sua implementação de AuthorizeConnection. Se a autenticação exigir mais de 1 segundo, recomendamos iniciar um thread separado para executar a autenticação.

Para obter um exemplo que usa o método OnConnectionAuthorized , consulte o exemplo autenticação e autorização conectáveis do Gateway de Área de Trabalho Remota .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7
Servidor mínimo com suporte	Windows Server 2008 R2
Plataforma de Destino	Windows
Cabeçalho	tsgpolicyengine.h

Confira também

ITSGAuthorizeConnectionSink