Condividi tramite

EAP_AUTHENTICATOR_METHOD_ROUTINES struttura (eapmethodauthenticatorapis.h)

Contiene un set di puntatori di funzione alle API del metodo EAPHost Authenticator.

Sintassi

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;

Members

dwSizeInBytes

Versione della struttura definita dall'implementazione.

Nota I valori per questo campo non sono definiti da Microsoft.
 

pEapType

Puntatore a una struttura EAP_METHOD_TYPE contenente le informazioni sul fornitore sull'implementazione delle API a cui puntano i membri della struttura.

EapMethodAuthenticatorInitialize

Puntatore alla funzione a EapMethodAuthenticatorInitialize.

pEapType

EAP_METHOD_TYPE valore di enumerazione che specifica il tipo di autenticazione EAP da usare per questa sessione.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati degli errori a EapPeerFreeErrorMemory.

EapMethodAuthenticatorBeginSession

Puntatore alla funzione a EapMethodAuthenticatorBeginSession.

dwFlags

Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.

pwszIdentity

Stringa Unicode con terminazione zero contenente l'identità dell'utente da autenticare.

pAttributeArray

Puntatore a una struttura di matrice EapAttributes che specifica gli attributi EAP dell'entità da autenticare.

dwSizeOfConnectionData

Specifica le dimensioni, in byte, del buffer dati di connessione fornito in pConnectionData.

pConnectionData

Puntatore a un buffer di byte che contiene il BLOB dati di configurazione opaco.

dwMaxSendPacketSize

Specifica le dimensioni massime, in byte, di un pacchetto EAP inviato durante la sessione.

pSessionHandle

Riceve un puntatore a una struttura EAP_SESSION_HANDLE contenente l'ID univoco per la nuova sessione di autenticazione EAP nel server EAPHost.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati degli errori a EapPeerFreeErrorMemory.

EapMethodAuthenticatorUpdateInnerMethodParams

Puntatore alla funzione a EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

dwFlags

Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.

pwszIdentity

Stringa Unicode con terminazione zero contenente l'identità aggiornata dell'utente da autenticare.

pAttributeArray

Puntatore a una struttura di matrice EapAttributes che specifica gli attributi EAP aggiornati dell'entità da autenticare.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorReceivePacket

Puntatore alla funzione a EapMethodAuthenticatorReceivePacket.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

cbReceivePacket

Dimensioni, in byte, di pReceivePacket.

pReceivePacket

Puntatore a una struttura EapPacket contenente un pacchetto di sessione di autenticazione EAP ricevuto dal supplicante dal server EAPHost.

pEapOutput

Riceve un puntatore a un valore di enumerazione EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION che indica l'azione successiva che deve essere eseguita nella sessione di autenticazione EAP.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSendPacket

Puntatore alla funzione a EapMethodAuthenticatorSendPacket.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

bPacketId

Specifica un valore ID numerico per il pacchetto da inviare.

pcbSendPacket

Specifica le dimensioni massime, in byte, del pacchetto da inviare. In caso di restituzione, questo parametro riceve le dimensioni, in byte, del pacchetto restituito in pEapPacket.

pSendPacket

Riceve un puntatore a una struttura EapPacket contenente il pacchetto da inviare al supplicante.

pTimeout

Riceve un puntatore a un valore EAP_AUTHENTICATOR_SEND_TIMEOUT che specifica il timeout per il pacchetto.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorGetAttributes

Puntatore alla funzione a EapMethodAuthenticatorGetAttributes.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

pAttribs

Riceve un puntatore a una struttura EapAttributes che contiene una matrice di attributi di risposta di autenticazione EAP per il supplicante.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorSetAttributes

Puntatore alla funzione a EapMethodAuthenticatorSetAttributes.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

pAttribs

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

pEapOutput

Riceve un puntatore a un valore di enumerazione EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION che specifica l'azione suggerita che deve essere eseguita come risposta agli attributi aggiornati.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorGetResult

Puntatore alla funzione a EapMethodAuthenticatorGetResult.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP nel server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession

pResult

Riceve un puntatore a una struttura EAP_METHOD_AUTHENTICATOR_RESULT contenente i risultati dell'autenticazione.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorEndSession

Puntatore alla funzione a EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE valore che contiene l'handle specifico per la sessione di autenticazione EAP da chiudere sul server EAPHost. Questo handle viene ottenuto da una chiamata precedente a EapMethodAuthenticatorBeginSession.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorShutdown

Puntatore alla funzione a EapMethodAuthenticatorShutdown.

pEapType

Valore di enumerazione EAP_METHOD_TYPE che specifica il tipo di autenticazione EAP utilizzata nella sessione.

ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore ai dati di errore a EapMethodAuthenticatorFreeErrorMemory.

Commenti

Ogni DLL del metodo di autenticazione EAP deve avere implementazioni pubbliche delle API seguenti.

Queste API vengono chiamate su un metodo di autenticazione EAP quando un autenticatore (server) EAPHost riceve una chiamata di routine remota specifica da un metodo EAP (peer) (client). Si noti che una corrispondenza uno-a-uno completa non esiste tra metodi peer EAP e metodi di autenticazione EAP; le chiamate API del metodo EAP authenticator specifiche devono essere eseguite in base ai requisiti dell'implementazione delle chiamate API del metodo EAP authenticator.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione eapmethodauthenticatorapis.h

Vedi anche

Strutture del metodo EAPHost Authenticator

EapMethodAuthenticatorGetInfo

  • Last updated on