Função EapHostPeerQueryUserBlobFromCredentialInputFields (eaphostpeerconfigapis.h)

  • Artigo

A função EapHostPeerQueryUserBlobFromCredentialInputFields obtém um BLOB de credencial que pode ser usado para iniciar a autenticação da entrada do usuário recebida da interface do usuário de Logon Único (SSO).

Sintaxe

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const BYTE                         *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

Parâmetros

[in] hUserImpersonationToken

Um identificador para o token de representação do usuário a ser usado nesta sessão.

[in] eapMethodType

Uma estrutura EAP_METHOD_TYPE que especifica o tipo de autenticação EAP a ser usada para esta sessão.

[in] dwFlags

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

[in] dwEapConnDataSize

O tamanho, em bytes, do buffer de dados de conexão fornecido em pConnectionData.

[in] pbEapConnData

Dados de conexão usados para o método EAP.

[in] pEapConfigInputFieldArray

Um ponteiro para um EAP_CONFIG_INPUT_FIELD_ARRAY estrutura que contém os dados do campo de entrada da interface do usuário. O chamador deve liberar os ponteiros internos usando a função EapHostPeerFreeMemory, começando no ponteiro mais interno.

[in, out] pdwUserBlobSize

Um ponteiro para um DWORD que especifica o tamanho, em bytes, do buffer apontado por ppbUserBlob. Se esse valor não estiver definido como zero, um ponteiro para um buffer do tamanho especificado neste parâmetro deverá ser fornecido para ppbUserBlob.

[in, out] ppbUserBlob

Um ponteiro para o BLOB de credenciais que pode ser usado na autenticação. A memória deve ser liberada chamando EapHostPeerFreeMemory. Se um valor não nulo for fornecido para esse parâmetro (o que significa que um BLOB de dados existente é passado para ele), o BLOB de dados fornecidos será atualizado e retornado nesse parâmetro. Se um valor BLOB não NULL for fornecido, a função LocalAlloc deverá ser usada.

[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.

Valor retornado

Nenhum

Comentários

EapHostPeerQueryUserBlobFromCredentialInputFields dá suporte ao SSO. Essa função supplicante, como EapHostPeerQueryCredentialInputFields, é usada apenas em um cenário de SSO.

Após EapHostPeerQueryUserBlobFromCredentialInputFields, EAPHost chama EapHostPeerBeginSession. O supplicante usa o sinalizador EAP_FLAG_PRE_LOGON em EapHostPeerBeginSession para indicar que o EAPHost deve fornecer SSO.

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