Funzione EapHostPeerQueryInteractiveUIInputFields (eaphostpeerconfigapis.h)
La funzione EapHostPeerQueryInteractiveUIInputFields ottiene i campi di input per i componenti interattivi dell'interfaccia utente da elevare sulla supplicante.
Sintassi
DWORD EapHostPeerQueryInteractiveUIInputFields(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
Parametri
[in] dwVersion
Numero di versione dell'API.
| Valore | Significato |
|---|---|
|
Versione dell'API peer EAPHost. |
[in] dwFlags
Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.
[in] dwSizeofUIContextData
Dimensioni dei dati di contesto in pUIContextData, in byte.
[in] pUIContextData
Puntatore a un BLOB che contiene i dati del contesto dell'interfaccia utente, rappresentati come puntatori interni ai dati dei campi. Questi puntatori interni devono essere liberati passandoli a EapHostPeerFreeMemory, a partire dal puntatore più interno.
[out] pEapInteractiveUIData
Puntatore che riceve una struttura EAP_INTERACTIVE_UI_DATA che contiene informazioni di configurazione per i componenti interattivi dell'interfaccia utente generati in un supplicante EAP. Il chiamante deve liberare i puntatori interni usando la funzione EapHostPeerFreeMemory, a partire dal puntatore più interno.
[out] ppEapError
Puntatore a un puntatore a 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 chiamando EapHostPeerFreeErrorMemory.
[in, out] ppvReserved
Riservato per utilizzi futuri. Questo parametro deve essere impostato su 0.
Valore restituito
nessuno
Osservazioni
È possibile usare EapHostPeerQueryInteractiveUIInputFields per supportare l'accesso Single Sign-On (SSO). Il supplicant usa il flag EAP_FLAG_PRE_LOGON in EapHostPeerBeginSession per indicare a EAPHost che deve essere fornito l'accesso SSO. Se il codice di azione EapHostPeerResponseInvokeUI viene ricevuto dopo aver chiamato EapHostPeerBeginSession, EAPHost chiama EapHostPeerQueryInteractiveUIInputFields e successivamente chiama EapHostPeerQueryUIBlobFromInteractiveUIInputFields.
Il supplicante deve chiamare il EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED viene restituito, il supplicante deve ricorrere al modello tradizionale di richiamo dell'interfaccia utente interattiva del metodo chiamando EapHostPeerInvokeInteractiveUI. Se si verifica un errore, EapHostPeerQueryInteractiveUIInputFields restituirà un codice restituito diverso da NULL.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | eaphostpeerconfigapis.h |
| Libreria | Eappcfg.lib |
| DLL | Eappcfg.dll |