Метод ITSGAuthorizeConnectionSink::OnConnectionAuthorized (tsgpolicyengine.h)

Статья
08/26/2023

Уведомляет шлюз удаленных рабочих столов (шлюз удаленных рабочих столов) о результате попытки авторизовать подключение.

Синтаксис

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

Параметры

[in] hrIn

Результат попытки авторизации. Укажите S_OK , чтобы указать, что попытка выполнена успешно. Укажите любое другое значение, указывающее, что попытка завершилась сбоем.

[in] mainSessionId

Уникальный идентификатор, назначенный запросу на подключение шлюзом удаленных рабочих столов.

[in] cbSoHResponse

Число байтов, на которые ссылается параметр pbSoHResponse .

[in] pbSoHResponse

Указатель на BYTE , указывающий ответ на запрос для инструкции о работоспособности (SoH). Если параметр hrIn не S_OK, этот параметр игнорируется.

[in] idleTimeout

Количество минут, в течение которых подключение может оставаться бездействующим перед отключением. Если параметр hrIn не S_OK, этот параметр игнорируется.

[in] sessionTimeout

Максимальное количество минут, отведенное для сеанса. Если параметр hrIn не S_OK, этот параметр игнорируется.

[in] sessionTimeoutAction

Действие, выполняемое по времени ожидания сеанса. Если параметр hrIn не S_OK, этот параметр игнорируется. Этот параметр может принимать одно из указанных ниже значений.

SESSION_TIMEOUT_ACTION_DISCONNECT

Отключите сеанс.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Автоматическая повторная проверки подлинности и повторная авторизация сеанса.

[in] trustClass

Этот параметр зарезервирован. Всегда присвойте ему значение AA_TRUSTEDUSER_TRUSTEDCLIENT. Если параметр hrIn не S_OK, этот параметр игнорируется.

[in] policyAttributes

Массив логических значений, указывающих параметры перенаправления, связанные с подключением. Каждый элемент массива соответствует значению перечисления PolicyAttributeType . Если параметр hrIn не S_OK, этот параметр игнорируется.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Этот метод можно вызвать из реализации AuthorizeConnection. Если проверка подлинности требует более 1 секунды, рекомендуется запустить отдельный поток для выполнения проверки подлинности.

Пример использования метода OnConnectionAuthorized см. в разделе Пример подключаемой проверки подлинности и авторизации шлюза удаленных рабочих столов .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	tsgpolicyengine.h

См. также раздел

ITSGAuthorizeConnectionSink

Поделиться через