Funzione EapPeerQueryInteractiveUIInputFields (eapmethodpeerapis.h)

Articolo
02/29/2024

La funzione EapPeerQueryInteractiveUIInputFields definisce l'implementazione di un'API del metodo EAP che fornisce i campi di input per i componenti interattivi dell'interfaccia utente da elevare sulla supplicante.

Sintassi

DWORD EapPeerQueryInteractiveUIInputFields(
  [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. Deve essere impostato su zero.

[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. La supplicante ha ottenuto questi puntatori interni dalle API di runtime di EAPHost.

[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.

[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 di errore a EapPeerFreeErrorMemory.

[in, out] ppvReserved

Riservato per l'utilizzo futuro. Deve essere impostato su NULL

Valore restituito

nessuno

Osservazioni

È possibile usare EapPeerQueryInteractiveUIInputFields per supportare l'accesso Single Sign-On (SSO). Il flag EAP_FLAG_PRE_LOGON in EapPeerBeginSession indica a EAPHost che deve essere fornito l'accesso SSO. Se il codice di azione EapPeerResponseInvokeUI viene ricevuto dopo aver chiamato EapPeerBeginSession, EAPHost chiama EapPeerQueryInteractiveUIInputFields e successivamente chiama EapPeerQueryUIBlobFromInteractiveUIInputFields.

Il supplicante deve chiamare sempre 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 EapPeerInvokeInteractiveUI. Se si verifica un errore, EapPeerQueryInteractiveUIInputFields restituirà un codice restituito diverso da NULL.

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

Vedi anche

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO e PLAP

Condividi tramite