estrutura PPP_EAP_INFO (raseapif.h)

Artigo
08/25/2023

A estrutura PPP_EAP_INFO fornece informações para o Gerenciador de Conexões sobre o protocolo de autenticação, incluindo ponteiros para funções localizadas na DLL de EAP.

Sintaxe

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;

Membros

dwSizeInBytes

Especifica o tamanho da estrutura PPP_EAP_INFO . RAS passa esse valor para a DLL de EAP. A DLL usa esse valor para determinar qual versão da estrutura de PPP_EAP_INFO RAS está usando.

dwEapTypeId

Especifica um protocolo de autenticação específico. Esse identificador deve ser exclusivo em toda a implementação do EAP em todo o setor. O implementador de um protocolo de autenticação deve obter esse identificador da IANA (Autoridade de Números Atribuídos à Internet).

RasEapInitialize

Ponteiro para a função RasEapInitialize para o protocolo de autenticação. O protocolo de autenticação define o valor desse membro. O protocolo de autenticação pode definir esse membro como NULL, caso em que o protocolo não exige RAS para chamar essa função.

fInitialize

Especifica se o protocolo de autenticação deve inicializar ou desinicializar. Esse parâmetro será TRUE se o protocolo inicializar e FALSE se o protocolo não for inicializado.

RasEapBegin

Ponteiro para a função RasEapBegin para o protocolo de autenticação solicitado. O protocolo de autenticação define o valor desse membro. Esse membro pode ser NULL, nesse caso, o protocolo de autenticação não requer nenhuma inicialização. Se esse membro for NULL, RAS ignorará o membro RasEapEnd .

ppWorkBuffer

Ponteiro para um ponteiro que, no retorno bem-sucedido, aponta para um buffer de trabalho. Esse buffer é opaco para RAS; o conteúdo do buffer é usado apenas pelo protocolo de autenticação. O gerenciador de conexões RAS passa um ponteiro para esse buffer para o protocolo de autenticação em chamadas subsequentes para RasEapMakeMessage.

pPppEapInput

Ponteiro para uma estrutura de PPP_EAP_INPUT que especifica informações de inicialização para a sessão de autenticação.

RasEapEnd

Ponteiro para a função RasEapEnd para o protocolo de autenticação. O protocolo de autenticação define o valor desse membro.

pWorkBuffer

Ponteiro para o buffer de trabalho a ser liberado.

RasEapMakeMessage

Ponteiro para a função RasEapMakeMessage para o protocolo de autenticação solicitado. O protocolo de autenticação define o valor desse membro.

pWorkBuf

Ponteiro para o buffer de trabalho. O protocolo de autenticação fornece a RAS um ponteiro para esse buffer por meio da função RasEapBegin .

pReceivePacket

Ponteiro para uma estrutura de PPP_EAP_PACKET que contém um pacote recebido. Um valor pReceivePacket de NULL indica que RAS está iniciando a caixa de diálogo com o protocolo de autenticação ou que ocorreu um tempo limite e o protocolo de autenticação deve reenviar o último pacote. O protocolo de autenticação deve determinar, com base no contexto, qual desses dois casos é verdadeiro.

pSendPacket

Ponteiro para uma estrutura de PPP_EAP_PACKET . O protocolo de autenticação pode usar essa estrutura para especificar um pacote a ser enviado.

cbSendPacket

Especifica o tamanho, em bytes, do buffer apontado por pSendPacket.

pEapOutput

Ponteiro para uma estrutura PPP_EAP_OUTPUT .

pEapInput

Ponteiro para uma estrutura de PPP_EAP_INPUT . Esse parâmetro pode ser NULL.

Comentários

Uma determinada DLL EAP pode implementar mais de um protocolo de autenticação. Use o membro dwEapTypeId para especificar para qual protocolo recuperar informações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	raseapif.h