Функция EapHostPeerQueryUIBlobFromInteractiveUIInputFields (eaphostpeerconfigapis.h)

Статья
02/28/2024

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

Синтаксис

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

Параметры

[in] dwVersion

Номер версии API.

Значение	Значение
EAPHOST_PEER_API_VERSION 1	Версия ОДНОранговых API EAPHost.

[in] dwFlags

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

[in] dwSizeofUIContextData

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

[in] pUIContextData

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

[in] pEapInteractiveUIData

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

[in, out] pdwSizeOfDataFromInteractiveUI

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

[in, out] ppDataFromInteractiveUI

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

[out] ppEapError

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

[in, out] ppvReserved

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

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

None

Remarks

Последовательность вызовов API запрашивающего.

Требования

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

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

Функции конфигурации запрашивающего участника EAPHost

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

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