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

Статья
08/23/2023

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

Синтаксис

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const BYTE                         *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

Параметры

[in] hUserImpersonationToken

Дескриптор маркера олицетворения пользователя для использования в этом сеансе.

[in] eapMethodType

Структура EAP_METHOD_TYPE , указывающая тип проверки подлинности EAP для этого сеанса.

[in] dwFlags

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

[in] dwEapConnDataSize

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

[in] pbEapConnData

Данные подключения, используемые для метода EAP.

[in] pEapConfigInputFieldArray

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

[in, out] pdwUserBlobSize

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

[in, out] ppbUserBlob

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

[out] ppEapError

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

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

None

Remarks

EapHostPeerQueryUserBlobFromCredentialInputFields поддерживает единый вход. Эта запрашиваемая функция, например EapHostPeerQueryCredentialInputFields, используется только в сценарии единого входа.

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

Требования


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

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

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

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

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