Funzione RasEapInvokeInteractiveUI (raseapif.h)

Articolo
08/25/2023

La gestione connessione RAS chiama la funzione RasEapInvokeInteractiveUI per visualizzare una finestra di dialogo per ottenere i dati di autenticazione dall'utente.

Sintassi

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Parametri

[in] dwEapTypeId

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

[in] hwndParent

Gestire la finestra padre per la finestra di dialogo.

[in] pUIContextData

Puntatore ai dati di contesto per l'interfaccia utente interattiva. Il protocollo di autenticazione fornisce un puntatore a questi dati come membro della struttura PPP_EAP_OUTPUT . Il Gestione connessioni RAS riceve la struttura PPP_EAP_OUTPUT come parametro di output dalla funzione RasEapMakeMessage.

[in] dwSizeOfUIContextData

Specifica le dimensioni dei dati di contesto. Il protocollo di autenticazione fornisce le dimensioni come membro della struttura PPP_EAP_OUTPUT . Il Gestione connessioni RAS riceve la struttura PPP_EAP_OUTPUT come parametro di output dalla funzione RasEapMakeMessage.

ppDataFromInteractiveUI

[out[ Puntatore a una variabile puntatore. In caso di esito positivo, questa variabile puntatore punta a un buffer di memoria che contiene i dati ottenuti dall'interfaccia utente interattiva. L'interfaccia utente interattiva alloca questa memoria. RAS passa questi dati al protocollo di autenticazione nella struttura PPP_EAP_INPUT , quindi RAS libera questa memoria chiamando RasEapFreeMemory.

Se l'interfaccia utente interattiva non ottiene dati specifici dell'utente, il puntatore che ppUserData punta a deve essere impostato su NULL.

[out] pdwSizeOfDataFromInteractiveUI

Puntatore a una variabile DWORD che riceve le dimensioni dei dati restituiti dall'interfaccia utente interattiva. Se l'interfaccia utente interattiva non ottiene dati specifici dell'utente, la variabile DWORD deve essere impostata su zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR. Controllare i parametri ppDataFromInteractiveUI e lpdwSizeOfDataFromInteractiveUI per determinare se la funzione ha restituito dati dall'interfaccia utente interattiva.

Se la funzione non è in grado di allocare memoria per i dati, 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 le funzioni RasEapInvokeInteractiveUI e RasEapFreeMemory possono supportare più protocolli di autenticazione. Il parametro dwEapTypeId specifica il protocollo di autenticazione per cui richiamare l'interfaccia utente interattiva.

Un puntatore ai dati restituiti dall'interfaccia utente interattiva viene passato al protocollo di autenticazione nel membro pDataFromInteractiveUI della struttura PPP_EAP_INPUT . La struttura PPP_EAP_INPUT viene passata come parametro alla funzione RasEapMakeMessage .

L'interfaccia utente interattiva deve supportare WM_COMMAND messaggi in cui LOWORD(wParam) è uguale a IDCANCEL.

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