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

Статья
08/23/2023

Создает диалоговое окно пользовательского интерактивного интерфейса для получения сведений об удостоверениях пользователя для метода EAP на клиенте.

Синтаксис

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

Параметры

[in] pEapType

Структура EAP_METHOD_TYPE , содержащая сведения о поставщике и авторе о методе EAP, используемом для проверки подлинности подключения.

[in] dwFlags

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

[in] hwndParent

Дескриптор родительского окна, которое будет порождать интерактивный диалог пользовательского интерфейса для получения данных удостоверения.

[in] dwSizeOfConnectionData

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

[in] pConnectionData

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

[out] dwSizeOfUserData

Задает размер в байтах данных удостоверения пользователя, возвращаемых в dwSizeOfUserData.

[in] pUserData

Указатель на данные пользователя, относящиеся к этой проверке подлинности, используемый для предварительного заполнения данных пользователя. При первом вызове этого API или при запуске нового сеанса проверки подлинности этот параметр имеет значение NULL. В противном случае задайте для этого параметра элемент pUserData структуры, на который указывает параметр ppResult , полученный eapPeerGetResult.

[out] pdwSizeOfUserDataOut

Указывает размер буфера ppUserDataOut в байтах.

[out] ppUserDataOut

Указатель на указатель на возвращенные данные пользователя. Данные передаются в EapPeerBeginSession в качестве входных данных pUserData.

[out] ppwszIdentity

Указатель на возвращенное удостоверение пользователя. Указатель будет включен в пакет ответа удостоверения и вернется на сервер.

[out] ppEapError

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

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

None

Remarks

Этот вызов выполняется одноранговым EAPHost с помощью указателя функции на этот API. Этот API должен быть реализован в методе EAP, загруженном EAPHost, и должен строго соответствовать синтаксису и типам параметров, указанным в документации.

Требования


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

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

Функции конфигурации однорангового метода EAPHost

EapPeerInvokeIdentityUI

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