Funzione EapPeerBeginSession (eapmethodpeerapis.h)

Avvia una sessione di autenticazione EAP nel peer EAPHost usando il metodo EAP.

Sintassi

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parametri

[in] dwFlags

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

[in] pAttributeArray

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

[in] hTokenImpersonateUser

Specifica un handle per il token di rappresentazione utente da usare in questa sessione.

[in] dwSizeofConnectionData

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

[in] pConnectionData

Dati di connessione specifici di questo metodo usato per decidere i dati utente restituiti da questa API, in cui i dati utente dipendono da una determinata configurazione dei dati di connessione. Quando questo parametro è NULL , l'implementazione del metodo deve usare valori predefiniti per la connessione.

[in] dwSizeofUserData

Specifica le dimensioni in byte del buffer dati utente fornito in pUserData.

[in] pUserData

Puntatore a un buffer di byte contenente il BLOB dati utente opaco.

[in] dwMaxSendPacketSize

Specifica le dimensioni massime in byte di un pacchetto EAP inviato durante la sessione. Se il metodo deve inviare un pacchetto maggiore della dimensione massima, il metodo deve contenere la frammentazione e la riassemblazione.

[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

Puntatore a un puntatore a una struttura di 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 chiamando EapPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

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

Requisiti

Vedi anche

Metodo peer EAPHost Run-Time Funzioni

EapPeerEndSession

SSO e PLAP