Funzione RasEapInvokeConfigUI (raseapif.h)

Articolo
08/25/2023

La gestione connessione RAS chiama la funzione RasEapInvokeConfigUI per visualizzare una finestra di dialogo per ottenere informazioni di configurazione dall'utente. RasEapInvokeConfigUI quando viene creata una nuova voce della rubrica telefonica o viene modificata una voce della rubrica telefonica esistente, purché il protocollo di autenticazione per la voce fornisca un'interfaccia utente di configurazione.

Sintassi

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Parametri

[in] dwEapTypeId

Specifica il protocollo di autenticazione per cui richiamare l'interfaccia utente di configurazione.

[in] hwndParent

Gestire la finestra padre per la finestra di dialogo dell'interfaccia utente.

[in] dwFlags

Specifica zero o più flag seguenti che qualificano il processo di autenticazione.

Flag	Significato
RAS_EAP_FLAG_ROUTER	Specifica che il computer che esegue l'accesso esterno è un router. L'assenza di questo flag indica che l'accesso al computer è un client RAS.
RAS_EAP_FLAG_8021X_AUTH	Specifica che questa sessione viene eseguita in un contesto wireless.
RAS_EAP_FLAG_GUEST_ACCESS	Specificato se il client vuole l'accesso guest. Questo flag viene normalmente usato nel caso di una connessione wireless in modo che se l'autenticazione non riesce per il numero di tentativi consecutivi del client wireless, se configurato per richiedere l'accesso guest, quindi passa questo flag. Il server RADIUS deve essere configurato per consentire l'accesso guest.

[in] pConnectionDataIn

Puntatore ai dati di connessione attualmente archiviati nella voce della rubrica telefonica. Se la voce della rubrica telefonica non contiene dati, questo parametro è NULL.

[in] dwSizeOfConnectionDataIn

Specifica le dimensioni dei dati di connessione attualmente archiviati nella voce della rubrica telefonica. Se la voce della rubrica telefonica per questa connessione non contiene dati, questo parametro è zero.

[out] ppConnectionDataOut

Puntatore a un puntatore che, in caso di esito positivo, punta ai nuovi dati di connessione da archiviare nella voce della rubrica telefonica. Nessuno di questi dati deve essere specifico del computer corrente; le voci della rubrica telefonica devono essere portabili dal computer al computer.

[out] pdwSizeOfConnectionDataOut

Puntatore a una DWORD che riceve le dimensioni dei nuovi dati di connessione da archiviare nella voce della rubrica telefonica.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione non è stata in grado di allocare memoria per i dati di configurazione, il valore restituito deve essere ERROR_NOT_ENOUGH_MEMORY.

Se la funzione ha esito negativo in un altro modo, il valore restituito deve essere un codice di errore appropriato da Winerror.h, Raserror.h o Mprerror.h.

Commenti

La DLL che implementa RasEapInvokeConfigUI e RasEapFreeMemory può supportare più di un protocollo di autenticazione. Il parametro dwEapTypeId specifica per quale protocollo richiamare l'interfaccia utente di configurazione.

RAS archivia i dati di connessione restituiti da RasEapInvokeConfigUI nella voce della rubrica telefonica per la connessione nel computer client.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	raseapif.h