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

Статья
08/23/2023

Функция EapPeerQueryUserBlobFromCredentialInputFields определяет реализацию функции метода EAP, которая получает данные большого двоичного объекта пользователя, предоставленные в интерактивном пользовательском интерфейсе единого входа (SSO), который создается в запрашиваемом объекте.

Синтаксис

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      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

Размер данных конфигурации единого входа EAP, на которые указывает pbEapConnData, в байтах.

[in] pbEapConnData

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

[in] pEapConfigInputFieldArray

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

[in, out] pdwUserBlobSize

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

[in, out] ppbUserBlob

Указатель, содержащий большой двоичный объект непрозрачных пользовательских данных.

[out] ppEapError

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

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

None

Remarks

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

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

Требования


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

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

EAP_CONFIG_INPUT_FIELD_ARRAY

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

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