Função EapHostPeerQueryInteractiveUIInputFields (eaphostpeerconfigapis.h)

A função EapHostPeerQueryInteractiveUIInputFields obtém os campos de entrada para componentes interativos da interface do usuário a serem gerados no suplicante.

Sintaxe

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

O número de versão da API.

Valor	Significado
EAPHOST_PEER_API_VERSION 1	A versão da API par EAPHost.

[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

Ponteiro para um BLOB que contém dados de contexto da interface do usuário, representados como ponteiros internos para dados de campo. Esses ponteiros internos devem ser liberados passando-os para EapHostPeerFreeMemory, começando com o ponteiro mais interno.

[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 suplicante EAP. O chamador deve liberar os ponteiros internos usando a função EapHostPeerFreeMemory, começando no ponteiro mais interno.

[out] ppEapError

Um ponteiro para um ponteiro para uma estrutura de EAP_ERROR que contém erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada chamando EapHostPeerFreeErrorMemory.

[in, out] ppvReserved

Reservado para uso futuro. Esse parâmetro deve ser definido como 0.

Valor retornado

Nenhum

Comentários

EapHostPeerQueryInteractiveUIInputFields pode ser empregado para dar suporte ao SSO (Logon Único). O supplicante usa o sinalizador EAP_FLAG_PRE_LOGON em EapHostPeerBeginSession para indicar ao EAPHost que o SSO deve ser fornecido. Se o código de ação EapHostPeerResponseInvokeUI for recebido depois de chamar EapHostPeerBeginSession, EAPHost chamará EapHostPeerQueryInteractiveUIInputFields e chamará posteriormente EapHostPeerQueryUIBlobFromInteractiveUIInputFields.

O supplicante deve chamar o EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED é retornado, o supplicante deve recorrer ao modelo tradicional de invocação da interface do usuário interativa do método chamando EapHostPeerInvokeInteractiveUI. Se houver um erro, EapHostPeerQueryInteractiveUIInputFields retornará um código de retorno diferente de NULL.

Requisitos

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	eaphostpeerconfigapis.h
Biblioteca	Eappcfg.lib
DLL	Eappcfg.dll

Confira também

Funções de configuração supplicante EAPHost

SSO e PLAP