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


Метод ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)

Выполняет проверку подлинности пользователя.

Шлюз удаленных рабочих столов (шлюз удаленных рабочих столов) вызывает этот метод при получении нового запроса на подключение. Подключаемый модуль проверки подлинности должен проверять подлинность пользователя на основе файла cookie, на который ссылается параметр cookieData . Затем подключаемый модуль проверки подлинности должен использовать интерфейс ITSGAuthenticateUserSink для уведомления шлюза удаленных рабочих столов о результате проверки подлинности.

Синтаксис

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

Параметры

[in] mainSessionId

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

[in] cookieData

Указатель на BYTE , содержащий файл cookie, предоставленный пользователем.

[in] numCookieBytes

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

[in] context

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

[in] pSink

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

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

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

Комментарии

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

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

Требования

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

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

ITSGAuthenticationEngine