Функция EapMethodAuthenticatorBeginSession (eapmethodauthenticatorapis.h)

Статья
02/29/2024

Создает новый сеанс проверки подлинности EAP на сервере EAPHost.

EapMethodAuthenticatorBeginSession — это прототип функции.

Синтаксис

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Параметры

[in] dwFlags

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

[in] bInitialId

Строка Юникода с нулевым завершением, содержащая удостоверение пользователя для проверки подлинности.

pwszIdentity

Удостоверение пользователя, прошедшего проверку подлинности.

[in] pAttributeArray

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

[in] dwSizeofConnectionData

Указывает размер данных в байтах, на которые указывает pConnectionData. Если pConnectionData имеет значение NULL, этот элемент равен нулю.

pConnectionData

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

[in] dwMaxSendPacketSize

Указывает максимальный размер (в байтах) пакета EAP, отправленного во время сеанса.

[out] pSessionHandle

Указатель на структуру EAP_SESSION_HANDLE , содержащую уникальный дескриптор для этого сеанса проверки подлинности EAP на сервере EAPHost.

[out] ppEapError

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

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

None

Remarks

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

Требования

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

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

Функции метода EAPHost Authenticator

EapHostPeerBeginSession

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