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

Notifica a la puerta de enlace de Escritorio remoto (puerta de enlace de Escritorio remoto) el resultado de un intento de autorizar una conexión.

Sintaxis

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

Resultado del intento de autorización. Especifique S_OK para indicar que el intento se realizó correctamente. Especifique cualquier otro valor para indicar que se produjo un error en el intento.

[in] mainSessionId

Identificador único asignado a la solicitud de conexión por puerta de enlace de Escritorio remoto.

[in] cbSoHResponse

Número de bytes al que hace referencia el parámetro pbSoHResponse .

[in] pbSoHResponse

Puntero a un BYTE que especifica la respuesta a la solicitud de una instrucción de mantenimiento (SoH). Si el parámetro hrIn no es S_OK, este parámetro se omite.

[in] idleTimeout

Número de minutos que la conexión puede permanecer inactiva antes de desconectarse. Si el parámetro hrIn no es S_OK, este parámetro se omite.

[in] sessionTimeout

Número máximo de minutos asignados a la sesión. Si el parámetro hrIn no es S_OK, este parámetro se omite.

[in] sessionTimeoutAction

Acción que se realizará cuando se agote el tiempo de espera de la sesión. Si el parámetro hrIn no es S_OK, este parámetro se omite. Este parámetro puede ser uno de los valores siguientes.

SESSION_TIMEOUT_ACTION_DISCONNECT

Desconecte la sesión.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Vuelva a autenticar y volver a autenticar la sesión de forma silenciosa.

[in] trustClass

Este parámetro está reservado. Establézcalo siempre en AA_TRUSTEDUSER_TRUSTEDCLIENT. Si el parámetro hrIn no es S_OK, este parámetro se omite.

[in] policyAttributes

Matriz de valores booleanos que especifican la configuración de redirección asociada a la conexión. Cada elemento de la matriz corresponde a un valor de la enumeración PolicyAttributeType . Si el parámetro hrIn no es S_OK, este parámetro se omite.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Puede llamar a este método desde la implementación de AuthorizeConnection. Si la autenticación requiere más de 1 segundo, se recomienda iniciar un subproceso independiente para realizar la autenticación.

Para obtener un ejemplo que usa el método OnConnectionAuthorized , consulte el ejemplo autenticación y autorización conectables de puerta de enlace de Escritorio remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	tsgpolicyengine.h

Consulte también

ITSGAuthorizeConnectionSink