Função EapPeerQueryInteractiveUIInputFields (eapmethodpeerapis.h)
A função EapPeerQueryInteractiveUIInputFields define a implementação de uma API de método EAP que fornece os campos de entrada para componentes interativos da interface do usuário a serem gerados no supplicante.
Sintaxe
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
O número de versão da API. Deve ser definido como zero.
[in] dwFlags
Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.
[in] dwSizeofUIContextData
O tamanho dos dados de contexto em pUIContextData, em bytes.
[in] pUIContextData
Um ponteiro para um BLOB que contém dados de contexto da interface do usuário, representados como ponteiros internos para dados de campo. O suplicante obteve esses ponteiros internos de APIs de tempo de execução do EAPHost.
[out] pEapInteractiveUIData
Ponteiro que recebe uma estrutura EAP_INTERACTIVE_UI_DATA que contém informações de configuração para componentes interativos da interface do usuário gerados em um suplicável EAP.
[out] ppEapError
Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém quaisquer erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapPeerFreeErrorMemory.
[in, out] ppvReserved
Reservado para uso futuro. Deve ser definido como NULL
Retornar valor
Nenhum
Comentários
EapPeerQueryInteractiveUIInputFields pode ser empregado para dar suporte ao SSO (Logon Único). O sinalizador EAP_FLAG_PRE_LOGON em EapPeerBeginSession indica ao EAPHost que o SSO deve ser fornecido. Se o código de ação EapPeerResponseInvokeUI for recebido após chamar EapPeerBeginSession, EAPHost chamará EapPeerQueryInteractiveUIInputFields e, posteriormente, chamará EapPeerQueryUIBlobFromInteractiveUIInputFields.
O supplicante deve chamar sempre o EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED é retornado, o suplicante deve recorrer ao modelo tradicional de invocação da interface do usuário interativa do método chamando EapPeerInvokeInteractiveUI. Se houver um erro, EapPeerQueryInteractiveUIInputFields retornará um código de retorno diferente de NULL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | eapmethodpeerapis.h |