Função EapPeerQueryCredentialInputFields (eapmethodpeerapis.h)

Define a implementação de uma função específica do método EAP que obtém os campos de entrada de credencial de logon único (SSO) do EAP para um método EAP.

Sintaxe

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

Parâmetros

[in] hUserImpersonationToken

Um token de representação para o usuário cujas credenciais devem ser solicitadas e obtidas.

[in] eapMethodType

Uma estrutura EAP_METHOD_TYPE que contém informações de fornecedor e autor sobre o método EAP usado para autenticar a conexão.

[in] dwFlags

Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.

[in] dwEapConnDataSize

O tamanho dos dados de byte de configuração de SSO do EAP apontados por pbEapConnData, em bytes.

[in] pbEapConnData

Um Ponteiro para um buffer de bytes opaco que contém o BLOB de dados de configuração do EAP.

[out] pEapConfigFieldsArray

Um Ponteiro para uma estrutura EAP_CONFIG_INPUT_FIELD_ARRAY que contém os campos de entrada a serem exibidos para o usuário suplicante. Os campos pwszData nos elementosEAP_CONFIG_INPUT_FIELD_DATA individuais são inicializados como NULL.

[out] ppEapError

Um ponteiro para o endereço de uma estrutura EAP_ERROR que contém 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.

Retornar valor

Nenhum

Comentários

EapPeerQueryCredentialInputFields dá suporte ao SSO. Essa função de método par, como EapPeerQueryUserBlobFromCredentialInputFields, é usada apenas em um cenário de SSO.

A implementação específica do método EAP dessa função é chamada por EAPHost sempre que um aplicativo suplicante chama EapHostPeerQueryCredentialInputFields. O implementador dessa função é responsável por garantir que o EAP_CONFIG_INPUT_FIELD_ARRAY retornado por essa função contenha definições de campo de entrada para cada parte dos dados de credencial que os métodos EAP solicitarão do usuário suplicante.

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

Confira também

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO e PLAP