Funzione EapHostPeerQueryUserBlobFromCredentialInputFields (eaphostpeerconfigapis.h)

La funzione EapHostPeerQueryUserBlobFromCredentialInputFields ottiene un BLOB di credenziali che può essere usato per avviare l'autenticazione dall'input dell'utente ricevuto dall'interfaccia utente Single Sign-On (SSO).

Sintassi

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const 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

Handle per il token di rappresentazione utente da usare in questa sessione.

[in] eapMethodType

Struttura EAP_METHOD_TYPE che specifica il tipo di autenticazione EAP da usare per questa sessione.

[in] dwFlags

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

[in] dwEapConnDataSize

Dimensioni, in byte, del buffer dei dati di connessione fornito in pConnectionData.

[in] pbEapConnData

Dati di connessione utilizzati per il metodo EAP.

[in] pEapConfigInputFieldArray

Puntatore a una struttura EAP_CONFIG_INPUT_FIELD_ARRAY contenente i dati del campo di input dell'interfaccia utente. Il chiamante deve liberare i puntatori interni usando la funzione EapHostPeerFreeMemory, a partire dal puntatore più interno.

[in, out] pdwUserBlobSize

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

[in, out] ppbUserBlob

Puntatore al BLOB delle credenziali che può essere usato nell'autenticazione. La memoria deve essere liberata chiamando EapHostPeerFreeMemory. Se viene fornito un valore non Null per questo parametro (ovvero viene passato un BLOB di dati esistente), il BLOB dei dati fornito verrà aggiornato e restituito in questo parametro. Se viene specificato un valore BLOB non NULL, è necessario usare la funzione LocalAlloc .

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

Valore restituito

nessuno

Osservazioni

EapHostPeerQueryUserBlobFromCredentialInputFields supporta l'accesso SSO. Questa funzione supplicante, ad esempio EapHostPeerQueryCredentialInputFields, viene usata solo in uno scenario SSO.

Dopo EapHostPeerQueryUserBlobFromCredentialInputFields, EAPHost chiama EapHostPeerBeginSession. La supplicant usa il flag EAP_FLAG_PRE_LOGON in EapHostPeerBeginSession per indicare che EAPHost deve fornire l'accesso SSO.

Requisiti

Vedi anche

Funzioni di configurazione supplicanti EAPHost

SSO e PLAP