Funzione EapMethodAuthenticatorBeginSession (eapmethodauthenticatorapis.h)

  • Articolo

Crea una nuova sessione di autenticazione EAP nel server EAPHost.

EapMethodAuthenticatorBeginSession è un prototipo di funzione.

Sintassi

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parametri

[in] dwFlags

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

[in] bInitialId

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

pwszIdentity

Identità dell'utente autenticato.

[in] pAttributeArray

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

[in] dwSizeofConnectionData

Specifica le dimensioni in byte dei dati a cui fa riferimento pConnectionData. Se pConnectionData è NULL, questo membro è zero.

pConnectionData

Puntatore ai dati di connessione ricevuti dall'interfaccia utente di configurazione del protocollo di autenticazione.

[in] dwMaxSendPacketSize

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

[out] pSessionHandle

Puntatore a una struttura EAP_SESSION_HANDLE che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost.

[out] ppEapError

Facoltativamente riceve un puntatore a un puntatore a una struttura di 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 EapMethodAuthenticatorFreeMemory.

Valore restituito

nessuno

Osservazioni

Questa chiamata viene eseguita da un EAPHost basato su autenticatore usando un puntatore di funzione a questa API. Questa API deve essere implementata nel metodo EAP authenticator caricato da EAPHost e deve essere strettamente conforme ai tipi di sintassi e di parametri specificati nella documentazione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione eapmethodauthenticatorapis.h

Vedi anche

Funzioni del metodo EAPHost Authenticator

EapHostPeerBeginSession