Función EapHostPeerInvokeInteractiveUI (eaphostpeerconfigapis.h)
Genera una interfaz de usuario interactiva que se usa para obtener las credenciales del usuario. Por ejemplo, esta función se puede usar para generar una interfaz de usuario que recupere las credenciales de una tarjeta inteligente y solicite al usuario que escriba el PIN correspondiente.
Se debe llamar a EapHostPeerInvokeInteractiveUI en los subprocesos que tienen COM inicializado para single Threaded Apartment. Esto se puede lograr llamando a COM API CoInitialize; cuando el supplicante ha terminado con el subproceso STA CoUninitialize debe llamarse antes de salir.
Sintaxis
DWORD EapHostPeerInvokeInteractiveUI(
[in] HWND hwndParent,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] hwndParent
Identificador de la ventana primaria en la que aparece el cuadro de diálogo de configuración.
[in] dwSizeofUIContextData
Tamaño, en bytes, del búfer al que apunta el parámetro pUIContextData .
[in] pUIContextData
Puntero a un búfer que contiene los datos de contexto de la interfaz de usuario suplicantes de EAPHost. EapHostPeerGetUIContext devuelve los datos de contexto. El búfer es de tamaño dwSizeOfUIContextData.
[out] pdwSizeOfDataFromInteractiveUI
Puntero a un DWORD que representa el tamaño, en bytes, del búfer al que apunta el parámetro ppDataFromInteractiveUI .
[out] ppDataFromInteractiveUI
Puntero a un puntero a un búfer de bytes que contiene datos de la interfaz de usuario interactiva necesaria para que la autenticación continúe. El parámetro ppDataFromInteractiveUI debe pasarse a EapHostPeerSetUIContext como parámetro IN pUIContextData. Después de consumir los datos, esta memoria debe liberarse llamando a EapHostPeerFreeMemory. El búfer es de tamaño pdwSizeofDataFromInteractiveUI.
[out] ppEapError
Puntero a un puntero a una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse llamando a EapHostPeerFreeErrorMemory.
Valor devuelto
None
Observaciones
El supplicante debe llamar a EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED , el suplicante debe recurrir al modelo tradicional de invocar la interfaz de usuario interactiva del método mediante una llamada a EapHostPeerInvokeInteractiveUI.
Si se llama, EapHostPeerInvokeInteractiveUI genera la interfaz de usuario para el método EAP después de que el supplicante llame a EapHostPeerGetUIContext. Esto ocurre cuando una llamada a EapHostPeerProcessReceivedPacket devuelve el código de acción EapHostPeerResponseInvokeUi . EapHostPeerGetUIContext devuelve el contexto de la interfaz de usuario que el supplicante pasa a EapHostPeerInvokeInteractiveUI para generar la interfaz de usuario.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | eaphostpeerconfigapis.h |
| Library | Eappcfg.lib |
| Archivo DLL | Eappcfg.dll |
Consulte también
Funciones de configuración de EAPHost Supplicant