структура EAP_AUTHENTICATOR_METHOD_ROUTINES (eapmethodauthenticatorapis.h)

Статья
08/23/2023

Содержит набор указателей функций на API метода EAPHost Authenticator.

Синтаксис

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

Члены

dwSizeInBytes

Версия структуры, определяемой реализацией.

Примечание Значения для этого поля не определены корпорацией Майкрософт.

pEapType

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

EapMethodAuthenticatorInitialize

Указатель функции на EapMethodAuthenticatorInitialize.

pEapType

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

ppEapError

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

EapMethodAuthenticatorBeginSession

Указатель функции на EapMethodAuthenticatorBeginSession.

dwFlags

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

pwszIdentity

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

pAttributeArray

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

dwSizeOfConnectionData

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

pConnectionData

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

dwMaxSendPacketSize

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

pSessionHandle

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

ppEapError

EapMethodAuthenticatorUpdateInnerMethodParams

Указатель функции на EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE значение, содержащее конкретный дескриптор для сеанса проверки подлинности EAP на сервере EAPHost. Этот дескриптор получается при предыдущем вызове EapMethodAuthenticatorBeginSession

dwFlags

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

pwszIdentity

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

pAttributeArray

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

ppEapError

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

EapMethodAuthenticatorReceivePacket

Указатель функции на EapMethodAuthenticatorReceivePacket.

sessionHandle

cbReceivePacket

Размер pReceivePacket (в байтах).

pReceivePacket

Указатель на структуру EapPacket , содержащую пакет сеанса проверки подлинности EAP, полученный сервером EAPHost от запрашивающего.

pEapOutput

Получает указатель на значение перечисления EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION , указывающее следующее действие, которое проситель должен выполнить в сеансе проверки подлинности EAP.

ppEapError

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

EapMethodAuthenticatorSendPacket

Указатель функции на EapMethodAuthenticatorSendPacket.

sessionHandle

bPacketId

Задает числовое значение идентификатора для отправляемого пакета.

pcbSendPacket

Указывает максимальный размер отправляемого пакета (в байтах). При возврате этот параметр получает размер (в байтах) пакета, возвращаемого в pEapPacket.

pSendPacket

Получает указатель на структуру EapPacket , содержащую пакет для отправки запрашивающей.

pTimeout

Получает указатель на значение EAP_AUTHENTICATOR_SEND_TIMEOUT , указывающее время ожидания для пакета.

ppEapError

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

EapMethodAuthenticatorGetAttributes

Указатель функции на EapMethodAuthenticatorGetAttributes.

sessionHandle

pAttribs

Получает указатель на структуру EapAttributes , содержащую массив атрибутов ответа проверки подлинности EAP для запрашивающего.

ppEapError

EapMethodAuthenticatorSetAttributes

Указатель функции на EapMethodAuthenticatorSetAttributes.

sessionHandle

pAttribs

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

pEapOutput

Получает указатель на значение перечисления EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION , указывающее предлагаемое действие, которое запрашивающий должен предпринять в качестве ответа на обновленные атрибуты.

ppEapError

EapMethodAuthenticatorGetResult

Указатель функции на EapMethodAuthenticatorGetResult.

sessionHandle

pResult

Получает указатель на структуру EAP_METHOD_AUTHENTICATOR_RESULT , содержащую результаты проверки подлинности.

ppEapError

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

EapMethodAuthenticatorEndSession

Указатель функции на EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE значение, содержащее конкретный дескриптор для закрытия сеанса проверки подлинности EAP на сервере EAPHost. Этот дескриптор получен предыдущим вызовом EapMethodAuthenticatorBeginSession.

ppEapError

EapMethodAuthenticatorShutdown

Указатель функции на EapMethodAuthenticatorShutdown.

pEapType

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

ppEapError

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

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

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	eapmethodauthenticatorapis.h

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

Структуры методов EAPHost Authenticator

EapMethodAuthenticatorGetInfo

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

структура EAP_AUTHENTICATOR_METHOD_ROUTINES (eapmethodauthenticatorapis.h)

Синтаксис

Члены

pEapType

ppEapError

dwFlags

pwszIdentity

pAttributeArray

dwSizeOfConnectionData

pConnectionData

dwMaxSendPacketSize

pSessionHandle

ppEapError

sessionHandle

dwFlags

pwszIdentity

pAttributeArray

ppEapError

sessionHandle

cbReceivePacket

pReceivePacket

pEapOutput

ppEapError

sessionHandle

bPacketId

pcbSendPacket

pSendPacket

pTimeout

ppEapError

sessionHandle

pAttribs

ppEapError

sessionHandle

pAttribs

pEapOutput

ppEapError

sessionHandle

pResult

ppEapError

sessionHandle

ppEapError

pEapType

ppEapError

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы