Метод 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 |