Funzione EapHostPeerQueryUIBlobFromInteractiveUIInputFields (eaphostpeerconfigapis.h)

Articolo
08/23/2023

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.

Valore	Significato
EAPHOST_PEER_API_VERSION 1	Versione delle 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.

[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

Requisito	Valore
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

Vedi anche

Funzioni di configurazione supplicant di EAPHost

SSO e PLAP

Condividi tramite