Funzione EapHostPeerSetResponseAttributes (eappapis.h)

Fornisce gli attributi di autenticazione EAP aggiornati a EAPHost.

Sintassi

DWORD EapHostPeerSetResponseAttributes(
  [in]  EAP_SESSIONID               sessionHandle,
  [in]  const EapAttributes * const pAttribs,
  [out] EapHostPeerResponseAction   *pEapOutput,
  [out] EAP_ERROR                   **ppEapError
);

Parametri

[in] sessionHandle

Puntatore a una struttura di EAP_SESSIONID che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionId in una chiamata precedente a EapHostPeerBeginSession.

[in] pAttribs

Puntatore a una struttura EapAttributes che contiene una matrice di nuovi attributi di risposta di autenticazione EAP da impostare per la supplicante in EAPHost.

[out] pEapOutput

Puntatore a un valore di enumerazione EapHostPeerResponseAction che specifica il codice azione per il passaggio successivo, il supplicante deve accettare come risposta.

[out] ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR . L'indirizzo deve essere impostato su NULL prima di chiamare questa funzione. Se sono disponibili dati di errore, viene ricevuto un puntatore all'indirizzo di una struttura di EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver usato i dati di errore, liberare questa memoria chiamando EapHostPeerFreeEapError.

Valore restituito

nessuno

Osservazioni

Per passare al passaggio successivo della macchina a stati dopo una chiamata a EapHostPeerGetResponseAttributes, il supplicante deve chiamare EapHostPeerSetResponseAttributes. La supplicante deve eseguire questa operazione per passare una struttura EapAttributes valida, anche se il supplicante non può usare gli attributi restituiti da EapHostPeerGetResponseAttributes.

Nell'esempio seguente viene illustrata una chiamata EapHostPeerSetResponseAttributes eseguita esclusivamente per passare allo stato successivo nella macchina a stati.

EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);

// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};

// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);

Requisiti

Vedi anche

Funzioni di runtime supplicant di EAPHost

EapHostPeerGetResponseAttributes