Funzione EapPeerQueryCredentialInputFields (eapmethodpeerapis.h)

Articolo
02/26/2024

Definisce l'implementazione di una funzione specifica del metodo EAP che ottiene i campi di input delle credenziali SSO (EAP Single Sign-On) per un metodo EAP.

Sintassi

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [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 fornitore e autore sul metodo EAP utilizzato per autenticare la connessione.

[in] dwFlags

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

[in] dwEapConnDataSize

Dimensioni dei dati dei byte di configurazione SSO EAP a cui punta pbEapConnData, in byte.

[in] pbEapConnData

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

[out] pEapConfigFieldsArray

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 su NULL.

[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 di errore a EapPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

EapPeerQueryCredentialInputFields supporta l'accesso SSO. Questa funzione del metodo peer, ad esempio EapPeerQueryUserBlobFromCredentialInputFields, viene usata solo in uno scenario SSO.

L'implementazione specifica del metodo EAP di questa funzione viene chiamata da EAPHost ogni volta che un'applicazione supplicante chiama EapHostPeerQueryCredentialInputFields. L'implementatore di questa funzione è responsabile di garantire che il EAP_CONFIG_INPUT_FIELD_ARRAY restituito da questa funzione contenga definizioni di campo di input per ogni dato delle credenziali che i metodi EAP richiederanno all'utente 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	eapmethodpeerapis.h

Vedi anche

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO e PLAP

Share via