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

Статья
08/23/2023

Возвращает данные пользователя и удостоверение пользователя после вызова EAPHost.

Синтаксис

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [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] dwFlags

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

[in] dwSizeofConnectionData

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

[in] pConnectionData

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

[in] dwSizeofUserData

Задает размер (в байтах) буфера данных пользователя, предоставленного в pUserData.

[in] pUserData

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

[in] hTokenImpersonateUser

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

[out] pfInvokeUI

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

[in, 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

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

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

EapPeerInvokeIdentityUI

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