структура PPP_EAP_INFO (raseapif.h)

Статья
03/08/2023

Структура PPP_EAP_INFO предоставляет диспетчер подключений сведения о протоколе проверки подлинности, включая указатели на функции, расположенные в библиотеке DLL EAP.

Синтаксис

typedef struct _PPP_EAP_INFO {
  DWORD  dwSizeInBytes;
  DWORD  dwEapTypeId;
  DWORD( )(BOOL fInitialize) *RasEapInitialize;
  DWORD(VOID **ppWorkBuffer,PPP_EAP_INPUT *pPppEapInput) * )(RasEapBegin;
  DWORD()(VOID *pWorkBuffer) * RasEapEnd;
  DWORD(ID *pWorkBuf,PPP_EAP_PACKET *pReceivePacket,PPP_EAP_PACKET *pSendPacket,DWORD cbSendPacket,PPP_EAP_OUTPUT *pEapOutput,PPP_EAP_INPUT *pEapInput) * )(VORasEapMakeMessage;
} PPP_EAP_INFO, *PPPP_EAP_INFO;

Члены

dwSizeInBytes

Задает размер структуры PPP_EAP_INFO . Ras передает это значение в библиотеку DLL EAP. Библиотека DLL использует это значение, чтобы определить, какая версия PPP_EAP_INFO структуры RAS используется.

dwEapTypeId

Указывает определенный протокол проверки подлинности. Этот идентификатор должен быть уникальным в рамках реализации EAP в масштабах всей отрасли. Разработчик протокола проверки подлинности должен получить этот идентификатор от центра IANA.

RasEapInitialize

Указатель на функцию RasEapInitialize для протокола проверки подлинности. Протокол проверки подлинности задает значение этого элемента. Протокол проверки подлинности может присвоить этому члену значение NULL, и в этом случае протокол не требует, чтобы служба RAS вызывала эту функцию.

fInitialize

Указывает, следует ли инициализировать или деинициализировать протокол проверки подлинности. Этот параметр имеет значение TRUE , если протокол инициализируется, и FALSE , если протокол не инициализируется.

RasEapBegin

Указатель на функцию RasEapBegin для запрошенного протокола проверки подлинности. Протокол проверки подлинности задает значение этого элемента. Этот элемент может иметь значение NULL. В этом случае протокол проверки подлинности не требует инициализации. Если этот элемент имеет значение NULL, RAS игнорирует элемент RasEapEnd .

ppWorkBuffer

Указатель на указатель, который при успешном возвращении указывает на рабочий буфер. Этот буфер непрозрачн для RAS; содержимое буфера используется только протоколом проверки подлинности. Диспетчер соединений RAS передает указатель на этот буфер протоколу проверки подлинности в последующих вызовах RasEapMakeMessage.

pPppEapInput

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

RasEapEnd

Указатель на функцию RasEapEnd для протокола проверки подлинности. Протокол проверки подлинности задает значение этого элемента.

pWorkBuffer

Указатель на рабочий буфер для освобождения.

RasEapMakeMessage

Указатель на функцию RasEapMakeMessage для запрошенного протокола проверки подлинности. Протокол проверки подлинности задает значение этого элемента.

pWorkBuf

Указатель на рабочий буфер. Протокол проверки подлинности предоставляет RAS указатель на этот буфер с помощью функции RasEapBegin .

pReceivePacket

Указатель на структуру PPP_EAP_PACKET , которая содержит полученный пакет. Значение pReceivePacket , равное NULL , указывает на то, что RAS инициирует диалоговое окно с помощью протокола проверки подлинности, или что истекло время ожидания и протокол проверки подлинности должен повторно отправить последний пакет. Протокол проверки подлинности должен определять в зависимости от контекста, какой из этих двух вариантов является истинным.

pSendPacket

Указатель на структуру PPP_EAP_PACKET . Протокол проверки подлинности может использовать эту структуру для указания пакета для отправки.

cbSendPacket

Указывает размер (в байтах) буфера, на который указывает pSendPacket.

pEapOutput

Указатель на структуру PPP_EAP_OUTPUT .

pEapInput

Указатель на структуру PPP_EAP_INPUT . Этот параметр может иметь значение NULL.

Данная библиотека DLL EAP может реализовать несколько протоколов проверки подлинности. Используйте член dwEapTypeId , чтобы указать, для какого протокола требуется извлечь сведения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	raseapif.h