Funzione EapHostPeerInvokeInteractiveUI (eaphostpeerconfigapis.h)

Genera un'interfaccia utente interattiva usata per ottenere le credenziali dall'utente. Ad esempio, questa funzione può essere usata per generare un'interfaccia utente che recupera le credenziali da una smart card e richiede all'utente di immettere il PIN corrispondente.

EapHostPeerInvokeInteractiveUI 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 EapHostPeerInvokeInteractiveUI(
  [in]  HWND       hwndParent,
  [in]  DWORD      dwSizeofUIContextData,
  [in]  const BYTE *pUIContextData,
  [out] DWORD      *pdwSizeOfDataFromInteractiveUI,
  [out] BYTE       **ppDataFromInteractiveUI,
  [out] EAP_ERROR  **ppEapError
);

Parametri

[in] hwndParent

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

[in] dwSizeofUIContextData

Dimensione, in byte, del buffer a cui punta il parametro pUIContextData .

[in] pUIContextData

Puntatore a un buffer contenente i dati del contesto dell'interfaccia utente supplicanti da EAPHost. I dati di contesto vengono restituiti da EapHostPeerGetUIContext. Il buffer è di dimensioni dwSizeOfUIContextData.

[out] pdwSizeOfDataFromInteractiveUI

Puntatore a un DWORD che rappresenta le dimensioni, in byte, del buffer a cui punta il parametro ppDataFromInteractiveUI .

[out] ppDataFromInteractiveUI

Puntatore a un puntatore a un buffer di byte che contiene dati dall'interfaccia utente interattiva necessaria per continuare l'autenticazione. Il parametro ppDataFromInteractiveUI deve essere passato a EapHostPeerSetUIContext come parametro IN pUIContextData. Dopo aver utilizzato i dati, questa memoria deve essere liberata chiamando EapHostPeerFreeMemory. Il buffer è di dimensioni pdwSizeofDataFromInteractiveUI.

[out] ppEapError

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

Valore restituito

nessuno

Osservazioni

Il supplicante deve chiamare EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED viene restituito, il supplicante deve ricorrere al modello tradizionale di richiamo dell'interfaccia utente interattiva del metodo chiamando EapHostPeerInvokeInteractiveUI.

Se viene chiamato, EapHostPeerInvokeInteractiveUI genera l'interfaccia utente per il metodo EAP dopo che la supplicante chiama EapHostPeerGetUIContext. Ciò si verifica quando una chiamata a EapHostPeerProcessReceivedPacket restituisce il codice azione EapHostPeerResponseInvokeUi . EapHostPeerGetUIContext restituisce il contesto dell'interfaccia utente che il supplicant passa quindi a EapHostPeerInvokeInteractiveUI per generare l'interfaccia utente.

Requisiti

Vedi anche

Funzioni di configurazione supplicanti EAPHost

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext