Funzione EapPeerQueryUIBlobFromInteractiveUIInputFields (eapmethodpeerapis.h)

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

Sintassi

DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [out]     BYTE                          **ppDataFromInteractiveUI,
  [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 nel parametro 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. Il supplicante ha ottenuto questi puntatori interni dalle funzioni di run-time di EAPHost.

[in] pEapInteractiveUIData

Puntatore che riceve una struttura di EAP_INTERACTIVE_UI_DATA che contiene informazioni di configurazione per i componenti interattivi dell'interfaccia utente generati in un supplicante EAP.

[out] pdwSizeOfDataFromInteractiveUI

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

[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 EapPeerFreeMemory, a partire dal puntatore più interno. Se viene fornito un valore non NULL per questo parametro, significa che viene passato un BLOB di dati esistente, il BLOB dati fornito verrà aggiornato e restituito in questo parametro.

[out] ppEapError

Puntatore all'indirizzo di 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 EapPeerFreeErrorMemory.

[in, out] ppvReserved

Riservato per utilizzi futuri. Questo parametro deve essere impostato su 0.

Valore restituito

nessuno

Osservazioni

Sequenza di chiamate api del metodo peer.

Requisiti

Vedi anche

Funzioni di configurazione supplicant di EAPHost

SSO e PLAP