Funzione EapPeerGetUIContext (eapmethodpeerapis.h)
Ottiene il contesto dell'interfaccia utente dal metodo EAP. Questa funzione è sempre seguita dalla funzione EapPeerInvokeInteractiveUI , seguita dalla funzione EapPeerSetUIContext .
Sintassi
DWORD EapPeerGetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
Parametri
[in] sessionHandle
Puntatore a una struttura EAP_SESSION_HANDLE che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionHandle in una chiamata precedente a EapPeerBeginSession.
[out] pdwSizeOfUIContextData
Puntatore a un valore che specifica le dimensioni del buffer di byte del contesto dell'interfaccia utente restituito in ppUIContextData.
[out] ppUIContextData
Puntatore a un indirizzo contenente un buffer di byte con i dati del contesto dell'interfaccia utente supplicanti da EAPHost.
[out] 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 degli errori a EapPeerFreeErrorMemory.
Valore restituito
nessuno
Osservazioni
EapPeerGetUIContext viene chiamato da EAPHost quando una chiamata precedente indica che è disponibile un contesto dell'interfaccia utente.
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | eapmethodpeerapis.h |