Función EapPeerQueryInteractiveUIInputFields (eapmethodpeerapis.h)
La función EapPeerQueryInteractiveUIInputFields define la implementación de una API de método EAP que proporciona los campos de entrada para que los componentes interactivos de la interfaz de usuario se generen en el supplicante.
Sintaxis
DWORD EapPeerQueryInteractiveUIInputFields(
[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. Debe establecerse en cero.
[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 los datos de campo. El supplicante obtuvo estos punteros internos de las API en tiempo de ejecución de EAPHost.
[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.
[out] ppEapError
Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapPeerFreeErrorMemory.
[in, out] ppvReserved
Reservado para uso futuro. Debe establecerse en NULL.
Valor devuelto
None
Observaciones
EapPeerQueryInteractiveUIInputFields se puede emplear para admitir el inicio de sesión único (SSO). La marca de EAP_FLAG_PRE_LOGON en EapPeerBeginSession indica a EAPHost que se debe proporcionar el inicio de sesión único. Si se recibe el código de acción EapPeerResponseInvokeUI después de llamar a EapPeerBeginSession, EAPHost llama a EapPeerQueryInteractiveUIInputFields y, posteriormente, llama a EapPeerQueryUIBlobFromInteractiveUIInputFields.
El supplicante debe llamar siempre a la EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED se devuelve, el suplicante debe recurrir al modelo tradicional de invocar la interfaz de usuario interactiva del método mediante una llamada a EapPeerInvokeInteractiveUI. Si se produce un error, EapPeerQueryInteractiveUIInputFields devolverá un código de retorno distinto de NULL.
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 | eapmethodpeerapis.h |