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

Статья
02/29/2024

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

Синтаксис

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] LPVOID          *ppvReserved
);

Параметры

[in] dwVersion

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

[in] eapMethodType

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

[in] dwFlags

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

[in] hwndParent

Дескриптор родительского окна, в котором будет отображаться диалоговое окно конфигурации.

[in] dwSizeofConnectionData

Размер буфера, указанный параметром pConnectionData , в байтах.

[in] pConnectionData

Указатель на данные конфигурации, используемые для метода EAP.

[in] dwSizeofUserData

Размер буфера, указанный параметром pUserData , в байтах.

[in] pUserData

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

[in, out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

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

[out] ppwszIdentity

Указатель на строку удостоверения пользователя, завершаемую null. После использования эту память необходимо освободить, вызвав EapHostPeerFreeMemory.

[out] ppEapError

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

[in, out] ppvReserved

Зарезервировано для последующего использования.

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

None

Требования

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

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

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

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