Función EapHostPeerQueryInteractiveUIInputFields (eaphostpeerconfigapis.h)
La función EapHostPeerQueryInteractiveUIInputFields obtiene los campos de entrada de los componentes interactivos de la interfaz de usuario que se van a generar en el supplicante.
Sintaxis
DWORD EapHostPeerQueryInteractiveUIInputFields(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
Parámetros
[in] dwVersion
Número de versión de la API.
| Valor | Significado |
|---|---|
|
La versión de la API del mismo nivel de EAPHost. |
[in] dwFlags
Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.
[in] dwSizeofUIContextData
Tamaño de los datos de contexto en pUIContextData, en bytes.
[in] pUIContextData
Puntero a un BLOB que contiene datos de contexto de la interfaz de usuario, representados como punteros internos a datos de campo. Estos punteros internos se deben liberar pasando a EapHostPeerFreeMemory, empezando por el puntero más interno.
[out] pEapInteractiveUIData
Puntero que recibe una estructura de EAP_INTERACTIVE_UI_DATA que contiene información de configuración para los componentes interactivos de la interfaz de usuario generados en un supplicante de EAP. El llamador debe liberar los punteros internos mediante la función EapHostPeerFreeMemory, comenzando en el puntero más interno.
[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.
[in, out] ppvReserved
Reservado para uso futuro. Este parámetro debe establecerse en 0.
Valor devuelto
None
Observaciones
EapHostPeerQueryInteractiveUIInputFields se puede emplear para admitir el inicio de sesión único (SSO). El suplicante usa la marca EAP_FLAG_PRE_LOGON en EapHostPeerBeginSession para indicar a EAPHost que se debe proporcionar el inicio de sesión único. Si se recibe el código de acción EapHostPeerResponseInvokeUI después de llamar a EapHostPeerBeginSession, EAPHost llama a EapHostPeerQueryInteractiveUIInputFields y, posteriormente, llama a EapHostPeerQueryUIBlobFromInteractiveUIInputFields.
El suplicante debe llamar al EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED se devuelve, el supplicante debe recurrir al modelo tradicional de invocar la interfaz de usuario interactiva del método mediante una llamada a EapHostPeerInvokeInteractiveUI. Si se produce un error, EapHostPeerQueryInteractiveUIInputFields devolverá un código de retorno distinto de NULL.
Requisitos
| 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 |