Função EapPeerInvokeIdentityUI (eapmethodpeerapis.h)
Gera uma caixa de diálogo de interface do usuário interativa personalizada para obter informações de identidade do usuário para o método EAP no cliente.
Sintaxe
DWORD EapPeerInvokeIdentityUI(
[in] EAP_METHOD_TYPE *pEapType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeOfConnectionData,
[in] const BYTE *pConnectionData,
[out] DWORD dwSizeOfUserData,
[in] const BYTE *pUserData,
[out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
Parâmetros
[in] pEapType
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] hwndParent
Um identificador para a janela pai que gerará a caixa de diálogo interativa da interface do usuário para obter os dados de identidade.
[in] dwSizeOfConnectionData
O tamanho, em bytes, dos dados de contexto da interface do usuário especificados por pUIContextData.
[in] pConnectionData
Um ponteiro para um buffer de bytes opaco que contém os dados de conexão.
[out] dwSizeOfUserData
Especifica o tamanho, em bytes, dos dados de identidade do usuário retornados em dwSizeOfUserData.
[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.
[out] pdwSizeOfUserDataOut
Especifica o tamanho, em bytes, do buffer ppUserDataOut .
[out] ppUserDataOut
Um ponteiro para o ponteiro dos 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 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 chamando EapPeerFreeErrorMemory.
Valor retornado
Nenhum
Comentários
Essa chamada é executada por um EAPHost baseado em pares 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 |