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

Consulte también

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO y PLAP