Compartilhar via

estrutura EAP_AUTHENTICATOR_METHOD_ROUTINES (eapmethodauthenticatorapis.h)

  • Artigo

Contém um conjunto de ponteiros de função para as APIs do Método Autenticador EAPHost.

Sintaxe

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;

Membros

dwSizeInBytes

A versão da estrutura definida pelo implementador.

Nota Os valores desse campo não são definidos pela Microsoft.
 

pEapType

Um ponteiro para uma estrutura EAP_METHOD_TYPE que contém as informações do fornecedor sobre o implementador das APIs apontadas pelos membros dessa estrutura.

EapMethodAuthenticatorInitialize

Ponteiro de função para EapMethodAuthenticatorInitialize.

pEapType

EAP_METHOD_TYPE valor de enumeração que especifica o tipo de autenticação EAP a ser usado para esta sessão.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapPeerFreeErrorMemory.

EapMethodAuthenticatorBeginSession

Ponteiro de função para EapMethodAuthenticatorBeginSession.

dwFlags

Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.

pwszIdentity

Cadeia de caracteres Unicode terminada em zero que contém a identidade do usuário a ser autenticado.

pAttributeArray

Um ponteiro para uma estrutura de matriz EapAttributes que especifica os atributos EAP da entidade a serem autenticados.

dwSizeOfConnectionData

Especifica o tamanho, em bytes, do buffer de dados de conexão fornecido em pConnectionData.

pConnectionData

Um ponteiro para um buffer de bytes que contém o BLOB de dados de configuração opaco.

dwMaxSendPacketSize

Especifica o tamanho máximo, em bytes, de um pacote EAP enviado durante a sessão.

pSessionHandle

Recebe um ponteiro para uma estrutura EAP_SESSION_HANDLE que contém a ID exclusiva para a nova sessão de autenticação EAP no EAPHost do servidor.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapPeerFreeErrorMemory.

EapMethodAuthenticatorUpdateInnerMethodParams

Ponteiro de função para EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

dwFlags

Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.

pwszIdentity

Cadeia de caracteres Unicode terminada em zero que contém a identidade atualizada do usuário a ser autenticado.

pAttributeArray

Um ponteiro para uma estrutura de matriz EapAttributes que especifica os atributos EAP atualizados da entidade a serem autenticados.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorReceivePacket

Ponteiro de função para EapMethodAuthenticatorReceivePacket.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

cbReceivePacket

O tamanho, em bytes, de pReceivePacket.

pReceivePacket

Um ponteiro para uma estrutura EapPacket que contém um pacote de sessão de autenticação EAP recebido do supplicante pelo servidor EAPHost.

pEapOutput

Recebe um ponteiro para um valor de enumeração EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION que indica a próxima ação que o supplicante deve executar na sessão de autenticação EAP.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSendPacket

Ponteiro de função para EapMethodAuthenticatorSendPacket.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

bPacketId

Especifica um valor de ID numérica para o pacote a ser enviado.

pcbSendPacket

Especifica o tamanho máximo, em bytes, do pacote a ser enviado. No retorno, esse parâmetro recebe o tamanho, em bytes, do pacote retornado em pEapPacket.

pSendPacket

Recebe um ponteiro para uma estrutura EapPacket que contém o pacote a ser enviado para o suplicante.

pTimeout

Recebe um ponteiro para um valor EAP_AUTHENTICATOR_SEND_TIMEOUT que especifica o tempo limite do pacote.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorGetAttributes

Ponteiro de função para EapMethodAuthenticatorGetAttributes.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

pAttribs

Recebe um ponteiro para uma estrutura EapAttributes que contém uma matriz de atributos de resposta de autenticação EAP para o supplicante.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorSetAttributes

Ponteiro de função para EapMethodAuthenticatorSetAttributes.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

pAttribs

Ponteiro para uma estrutura EapAttributes que contém uma matriz de novos atributos de resposta de autenticação EAP a serem definidos para o supplicante no EAPHost.

pEapOutput

Recebe um ponteiro para um valor de enumeração EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION que especifica a ação sugerida que o supplicante deve tomar como resposta aos atributos atualizados.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorGetResult

Ponteiro de função para EapMethodAuthenticatorGetResult.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP no servidor EAPHost. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession

pResult

Recebe um ponteiro para uma estrutura EAP_METHOD_AUTHENTICATOR_RESULT que contém os resultados da autenticação.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorEndSession

Ponteiro de função para EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE valor que contém o identificador específico para a sessão de autenticação EAP ser fechada no EAPHost do servidor. Esse identificador é obtido por uma chamada anterior para EapMethodAuthenticatorBeginSession.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorShutdown

Ponteiro de função para EapMethodAuthenticatorShutdown.

pEapType

Um EAP_METHOD_TYPE valor de enumeração que especifica o tipo de autenticação EAP usado na sessão.

ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeErrorMemory.

Comentários

Cada DLL do método autenticador EAP deve ter implementações públicas das APIs a seguir.

Essas APIs são chamadas em um método autenticador EAP quando um EAPHost de autenticador (servidor) recebe uma chamada de procedimento remoto correspondente específica de um método EAP par (cliente). Observe que uma correspondência um-para-um completa não existe entre métodos pares EAP e métodos de autenticador EAP; as chamadas de API específicas do método autenticador EAP devem ser feitas com base nos requisitos da implementação das chamadas à API do método autenticador EAP.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho eapmethodauthenticatorapis.h

Confira também

Estruturas do método Authenticator EAPHost

EapMethodAuthenticatorGetInfo