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.

[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

Vedi anche

Funzioni di configurazione supplicanti EAPHost

SSO e PLAP