Funzione EapPeerQueryUserBlobFromCredentialInputFields (eapmethodpeerapis.h)

Articolo
08/23/2023

La funzione EapPeerQueryUserBlobFromCredentialInputFields definisce l'implementazione di una funzione di metodo EAP che ottiene i dati BLOB utente forniti in un'interfaccia utente di Single Sign-On (SSO) interattiva generata nel supplicante.

Sintassi

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      BYTE                               *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

Parametri

[in] hUserImpersonationToken

Token di rappresentazione per l'utente le cui credenziali devono essere richieste e ottenute.

[in] eapMethodType

Struttura EAP_METHOD_TYPE che contiene informazioni sul fornitore e sull'autore del metodo EAP usato per autenticare la connessione.

[in] dwFlags

Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.

[in] dwEapConnDataSize

Dimensioni dei dati di configurazione dell'accesso SSO EAP a cui fa riferimento pbEapConnData, in byte.

[in] pbEapConnData

Puntatore a un buffer di byte opaco che contiene il BLOB dei dati di configurazione di EAP SSO.

[in] pEapConfigInputFieldArray

Puntatore a una struttura EAP_CONFIG_INPUT_FIELD_ARRAY che contiene i campi di input da visualizzare all'utente supplicante. I campi pwszData nei singoli elementi EAP_CONFIG_INPUT_FIELD_DATA vengono inizializzati in NULL.

[in, out] pdwUserBlobSize

Puntatore a un buffer contenente le dimensioni, in byte, del BLOB dati di configurazione utente opaco in ppUserBlob.

[in, out] ppbUserBlob

Puntatore che contiene il BLOB dati utente opaco.

[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 degli errori a EapPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

EapPeerQueryUserBlobFromCredentialInputFields supporta Single Sign-On (SSO). Questa funzione del metodo peer, ad esempio EapPeerQueryCredentialInputFields, viene usata solo in uno scenario SSO.

Dopo EapPeerQueryUserBlobFromCredentialInputFields, EAPHost chiama EapPeerBeginSession. Il supplicant usa il flag di EAP_FLAG_PRE_LOGON in EapHostPeerBeginSession per indicare che EAPHost deve fornire l'accesso SSO.

Requisiti


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