Funzione EapPeerInvokeIdentityUI (eapmethodpeerapis.h)

Genera una finestra di dialogo dell'interfaccia utente interattiva personalizzata per ottenere informazioni sull'identità utente per il metodo EAP nel client.

Sintassi

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

Parametri

[in] pEapType

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

Handle per la finestra padre che genererà la finestra di dialogo interattiva dell'interfaccia utente per ottenere i dati di identità.

[in] dwSizeOfConnectionData

Dimensioni, in byte, dei dati del contesto dell'interfaccia utente specificati da pUIContextData.

[in] pConnectionData

Puntatore a un buffer di byte opaco che contiene i dati di connessione.

[out] dwSizeOfUserData

Specifica le dimensioni, in byte, dei dati di identità utente restituiti in dwSizeOfUserData.

[in] pUserData

Puntatore ai dati utente specifici di questa autenticazione usata per precompilare i dati utente. Quando questa API viene chiamata per la prima volta o quando viene avviata una nuova sessione di autenticazione, questo parametro è NULL. In caso contrario, impostare questo parametro sul membro pUserData della struttura a cui punta il parametro ppResult ricevuto da EapPeerGetResult.

[out] pdwSizeOfUserDataOut

Specifica le dimensioni, in byte, del buffer ppUserDataOut .

[out] ppUserDataOut

Puntatore al puntatore dei dati utente restituiti. I dati vengono passati a EapPeerBeginSession come input pUserData.

[out] ppwszIdentity

Puntatore all'identità utente restituita. Il puntatore verrà incluso nel pacchetto di risposta identity e restituito al server.

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

Valore restituito

nessuno

Osservazioni

Questa chiamata viene eseguita da un EAPHost basato su peer usando un puntatore a funzione a questa API. Questa API deve essere implementata nel metodo EAP caricato da EAPHost e deve essere strettamente conforme alla sintassi e ai tipi di parametro specificati nella documentazione.

Requisiti

Vedi anche

Funzioni di configurazione del metodo peer EAPHost

EapPeerInvokeIdentityUI