Funzione EapHostPeerGetUIContext (eappapis.h)

Ottiene il contesto dell'interfaccia utente per il supplicante da EAPHost se l'interfaccia utente deve essere generata.

EAPHostPeerGetUIContext è sempre seguito dalle funzioni seguenti.

• EapHostPeerInvokeInteractiveUI e
• EapHostPeerSetUIContext

Sintassi

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [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.

[out] pdwSizeOfUIContextData

Puntatore a un valore che specifica le dimensioni, in byte, del buffer di dati del contesto dell'interfaccia utente restituito in ppUIContextData.

[out] ppUIContextData

Puntatore a un puntatore a un buffer contenente i dati del contesto dell'interfaccia utente supplicanti da EAPHost. L'indirizzo a cui punta questo parametro viene passato a EapHostPeerInvokeInteractiveUI come parametro IN pUIContextData.

[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

Requisiti

Vedi anche

Funzioni di runtime supplicant di EAPHost

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext