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

Метод ITSGAuthenticateUserSink::OnUserAuthenticationFailed (tsgauthenticationengine.h)

  • Статья

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

Синтаксис

HRESULT OnUserAuthenticationFailed(
  [in] ULONG_PTR context,
  [in] HRESULT   genericErrorCode,
  [in] HRESULT   specificErrorCode
);

Параметры

[in] context

Указатель на ULONG , содержащий значение, идентифицирующее это соединение. Используйте значение, переданное методом AuthenticateUser .

[in] genericErrorCode

Код ошибки Windows, указывающий причину сбоя проверки подлинности.

[in] specificErrorCode

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

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

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

Комментарии

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

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

Требования

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

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

ITSGAuthenticateUserSink