Funzione EapMethodAuthenticatorInvokeConfigUI (eapmethodauthenticatorapis.h)

Definisce una funzione che genera la finestra di dialogo dell'interfaccia utente di configurazione della connessione del metodo EAP nel client.

EapMethodAuthenticatorInvokeConfigUI è un prototipo di funzione.

EapHostAuthenticatorInvokeConfigUI deve essere chiamato nei thread con COM inizializzato per apartment a thread singolo. A tale scopo, è possibile chiamare COInitialize dell'API COM; al termine della supplicante con il thread STA CoUninitialize deve essere chiamato prima di uscire.

Sintassi

DWORD EapMethodAuthenticatorInvokeConfigUI(
  [in]  EAP_METHOD_TYPE *pEapMethodType,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwFlags,
  [in]  LPCWSTR         pwszMachineName,
  [in]  DWORD           dwSizeOfConfigIn,
  [in]  BYTE            *pConfigIn,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_ERROR       **ppEapError
);

Parametri

[in] pEapMethodType

Puntatore a una struttura EAP_METHOD_TYPE che contiene informazioni fornitore e autore sul metodo EAP utilizzato per autenticare la connessione.

[in] hwndParent

Handle per la finestra padre che avvierà la finestra di dialogo dell'interfaccia utente di configurazione della connessione.

[in] dwFlags

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

[in] pwszMachineName

Nome del computer di destinazione da configurare. NULL indica che il computer locale è in fase di configurazione.

[in] dwSizeOfConfigIn

Specifica le dimensioni, in byte, di pConfigIn. Può essere impostato su 0.

[in] pConfigIn

Puntatore a un buffer di byte che contiene elementi di configurazione. Il buffer è di dimensioni dwSizeOfConfigIn. Questo parametro può essere NULL se dwSizeOfConfigIn è impostato su 0.

[out] pdwSizeOfConfigOut

Specifica le dimensioni, in byte, dei dati di configurazione restituiti in ppConfigOut.

[out] ppConfigOut

Puntatore a un puntatore a un buffer di byte contenente i dati di configurazione aggiornati dell'utente. Dopo aver utilizzato i dati, questa memoria deve essere liberata chiamando EapMethodAuthenticatorFreeMemory.

[out] ppEapError

Puntatore all'indirizzo di 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 EapMethodAuthenticatorFreeErrorMemory.

Valore restituito

nessuno

Requisiti

Vedi anche

Funzioni del metodo EAPHost Authenticator