Função EapPeerGetIdentity (eapmethodpeerapis.h)
Retorna os dados do usuário e a identidade do usuário depois de ser chamado pelo EAPHost.
Sintaxe
DWORD EapPeerGetIdentity(
[in] DWORD dwFlags,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
Parâmetros
[in] dwFlags
Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.
[in] dwSizeofConnectionData
Especifica o tamanho, em bytes, do buffer de dados de conexão fornecido em pConnectionData
[in] pConnectionData
Um ponteiro para um buffer de bytes que contém o BLOB de dados de configuração opaco.
[in] dwSizeofUserData
Especifica o tamanho, em bytes, do buffer de dados do usuário fornecido em pUserData.
[in] pUserData
Um ponteiro para os dados do usuário específicos para essa autenticação usada para preencher previamente os dados do usuário. Quando essa API é chamada pela primeira vez ou quando uma nova sessão de autenticação é iniciada, esse parâmetro é NULL. Caso contrário, defina esse parâmetro como o membro pUserData da estrutura apontada pelo parâmetro ppResult recebido por EapPeerGetResult.
[in] hTokenImpersonateUser
Especifica um identificador para o token de representação do usuário que está sendo autenticado. Esse identificador será NULL ao fazer a autenticação do computador. Usando esse identificador, um método EAP pode representar o usuário com a finalidade de obter informações específicas do usuário, como nome de usuário, nome de domínio e credenciais.
[out] pfInvokeUI
Retornará TRUE se a identidade do usuário e o blob de dados do usuário não forem retornados com êxito e o método buscar coletar as informações do usuário por meio da caixa de diálogo de interface do usuário.
[in, out] pdwSizeOfUserDataOut
Especifica o tamanho, em bytes, do buffer ppUserDataOut .
[out] ppUserDataOut
Um ponteiro para um ponteiro para os dados de usuário retornados. Os dados são passados para EapPeerBeginSession como pUserData de entrada.
[out] ppwszIdentity
Um ponteiro para a identidade do usuário retornada. O ponteiro será incluído no pacote de resposta de identidade e retornado ao servidor.
[out] ppEapError
Um ponteiro para o ponteiro para 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 chamando EapPeerFreeErrorMemory.
Valor retornado
Nenhum
Comentários
Essa chamada é executada por um EAPHost baseado em par usando um ponteiro de função para essa API. Essa API deve ser implementada no método EAP carregado pelo EAPHost e deve estar estritamente em conformidade com a sintaxe e os tipos de parâmetro especificados na documentação.
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 | eapmethodpeerapis.h |