Функция EapHostPeerGetUIContext (eappapis.h)

2023-08-23

Получает контекст пользовательского интерфейса для запрашивающего пользователя из EAPHost, если требуется создать пользовательский интерфейс.

За EAPHostPeerGetUIContext всегда следуют следующие функции.

Синтаксис

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [out] EAP_ERROR     **ppEapError
);

Параметры

[in] sessionHandle

Указатель на структуру EAP_SESSIONID , содержащую уникальный дескриптор для этого сеанса проверки подлинности EAP на сервере EAPHost. Этот дескриптор возвращается в параметре pSessionId при предыдущем вызове EapHostPeerBeginSession.

[out] pdwSizeOfUIContextData

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

[out] ppUIContextData

Указатель на указатель на буфер, содержащий запрашиваемые данные контекста пользовательского интерфейса из EAPHost. Адрес, на который указывает этот параметр, передается в EapHostPeerInvokeInteractiveUI как IN-параметр pUIContextData.

[out] ppEapError

Указатель на адрес структуры EAP_ERROR . Перед вызовом этой функции адрес должен иметь значение NULL . Если данные об ошибках доступны, получается указатель на адрес структуры EAP_ERROR , содержащей все ошибки, возникающие во время выполнения этого вызова функции. После использования данных об ошибке освободите эту память, вызвав EapHostPeerFreeEapError.

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

None

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	eappapis.h
Библиотека	Eappprxy.lib
DLL	Eappprxy.dll

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

Функции времени выполнения приложения EAPHost

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext