Funzione EapHostPeerQueryUIBlobFromInteractiveUIInputFields (eaphostpeerconfigapis.h)

La funzione EapHostPeerQueryUIBlobFromInteractiveUIInputFields converte le informazioni utente in un BLOB utente che può essere utilizzato dalle funzioni di runtime di EAPHost.

Sintassi

DWORD EapHostPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [in, out] DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [in, out] BYTE                          **ppDataFromInteractiveUI,
  [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.

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

[in, out] pdwSizeOfDataFromInteractiveUI

Puntatore a un DWORD che specifica le dimensioni, in byte, del buffer a cui punta ppDataFromInteractiveUI. Se questo valore non è impostato su zero, è necessario specificare un puntatore a un buffer delle dimensioni specificate in questo parametro per ppDataFromInteractiveUI.

[in, out] ppDataFromInteractiveUI

Puntatore che riceve un BLOB di credenziali che può essere usato nell'autenticazione. Il chiamante deve liberare i puntatori interni usando la funzione EapHostPeerFreeMemory, a partire dal puntatore più interno. Se viene fornito un valore non Null per questo parametro (ovvero che viene passato un BLOB di dati esistente), il BLOB dati fornito verrà aggiornato e restituito in questo parametro. Se viene specificato un valore BLOB non NULL, la funzione LocalAlloc deve essere usata.

[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

Sequenza di chiamate API supplicante.

Requisiti

Vedi anche

Funzioni di configurazione supplicant di EAPHost

SSO e PLAP