Функция EapHostPeerGetIdentity (eappapis.h)

Статья
08/23/2023

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

Синтаксис

DWORD EapHostPeerGetIdentity(
  [in]      DWORD           dwVersion,
  [in]      DWORD           dwFlags,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in]      HANDLE          hTokenImpersonateUser,
  [out]     BOOL            *pfInvokeUI,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] BYTE            **ppvReserved
);

Параметры

[in] dwVersion

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

[in] dwFlags

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

[in] eapMethodType

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

[in] dwSizeofConnectionData

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

[in] pConnectionData

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

[in] dwSizeofUserData

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

[in] pUserData

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

[in] hTokenImpersonateUser

Токен олицетворения для вошедшего в систему пользователя для сбора сведений, связанных с пользователем.

[out] pfInvokeUI

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

[in, out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

Сведения о пользовательских данных, возвращаемые методом . После использования эту память необходимо освободить, вызвав EapHostPeerFreeRuntimeMemory.

[out] ppwszIdentity

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

[out] ppEapError

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

[in, out] ppvReserved

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

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

None

Требования


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

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

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

EapHostPeerGetUIContext

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