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