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

Запускает сеанс проверки подлинности EAP на одноранговом узле EAPHost с помощью метода EAP.

Синтаксис

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Параметры

[in] dwFlags

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

[in] pAttributeArray

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

[in] hTokenImpersonateUser

Указывает дескриптор маркера олицетворения пользователя для использования в этом сеансе.

[in] dwSizeofConnectionData

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

[in] pConnectionData

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

[in] dwSizeofUserData

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

[in] pUserData

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

[in] dwMaxSendPacketSize

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

[out] pSessionHandle

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

[out] ppEapError

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

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

None

Remarks

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

Требования

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

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

EapPeerEndSession

Единый вход и PLAP