Функция EapPeerQueryUIBlobFromInteractiveUIInputFields (eapmethodpeerapis.h)

Статья
08/23/2023

Функция EapPeerQueryUIBlobFromInteractiveUIInputFields преобразует сведения о пользователе в большой двоичный объект пользователя, который может использоваться функциями среды выполнения EAPHost.

Синтаксис

DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [out]     BYTE                          **ppDataFromInteractiveUI,
  [out]     EAP_ERROR                     **ppEapError,
  [in, out] LPVOID                        *ppvReserved
);

Параметры

[in] dwVersion

Номер версии API. Необходимо задать нулевое значение.

[in] dwFlags

Сочетание флагов EAP , описывающих поведение сеанса проверки подлинности EAP.

[in] dwSizeofUIContextData

Размер контекстных данных в параметре pUIContextData в байтах.

[in] pUIContextData

Указатель на большой двоичный объект, содержащий данные контекста пользовательского интерфейса, представленный в виде внутренних указателей на данные полей. Запрашивающий получил эти внутренние указатели из функций среды выполнения EAPHost.

[in] pEapInteractiveUIData

Указатель, получающий структуру EAP_INTERACTIVE_UI_DATA , содержащую сведения о конфигурации для компонентов интерактивного пользовательского интерфейса, возникающих в запросе EAP.

[out] pdwSizeOfDataFromInteractiveUI

Указатель на DWORD, указывающий размер буфера, на который указывает параметр ppDataFromInteractiveUI , в байтах. Если это значение не равно 0, в параметре ppDataFromInteractiveUI должен быть указан указатель на буфер размера, указанного в этом параметре.

[out] ppDataFromInteractiveUI

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

[out] ppEapError

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

[in, out] ppvReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение 0.

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

None

Remarks

Последовательность вызовов API однорангового метода.

Требования

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

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

Функции конфигурации запрашивающего приложения EAPHost

Единый вход и PLAP

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