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 |