Funzione EapHostPeerInvokeIdentityUI (eaphostpeerconfigapis.h)

Questa funzione viene chiamata dai metodi di tunnel per richiamare l'interfaccia utente di identità dei metodi interni. Questa funzione restituisce l'identità e le credenziali da usare per avviare l'autenticazione.

Sintassi

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] LPVOID          *ppvReserved
);

Parametri

[in] dwVersion

Numero di versione dell'API. Deve essere impostato su zero.

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

Handle della finestra padre in cui verrà visualizzata la finestra di dialogo di configurazione.

[in] dwSizeofConnectionData

Dimensioni del buffer indicate dal parametro pConnectionData , in byte.

[in] pConnectionData

Puntatore ai dati di configurazione usati per il metodo EAP.

[in] dwSizeofUserData

Dimensioni del buffer indicate dal parametro pUserData , in byte.

[in] pUserData

Puntatore alle informazioni sulle credenziali utente relative a questa autenticazione.

[in, out] pdwSizeOfUserDataOut

Dimensione del buffer impostato per ricevere i dati utente restituiti dal parametro ppUserDataOut , in byte.

[out] ppUserDataOut

Puntatore a un puntatore a un buffer che contiene informazioni sui dati utente restituiti dal metodo . Dopo l'uso, questa memoria deve essere liberata chiamando EapHostPeerFreeMemory.

[out] ppwszIdentity

Puntatore a una stringa di identità utente con terminazione NULL. Dopo l'uso, questa memoria deve essere liberata chiamando EapHostPeerFreeMemory.

[out] ppEapError

Puntatore a un puntatore a 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 EapHostPeerFreeErrorMemory.

[in, out] ppvReserved

Riservato per utilizzi futuri.

Valore restituito

nessuno

Requisiti

Vedi anche

Funzioni di configurazione supplicanti EAPHost