Função EapHostPeerInvokeInteractiveUI (eaphostpeerconfigapis.h)
Gera uma interface do usuário interativa usada para obter credenciais do usuário. Por exemplo, essa função pode ser usada para gerar uma interface do usuário que recupera credenciais de um cartão inteligente e solicita que o usuário insira o PIN correspondente.
EapHostPeerInvokeInteractiveUI deve ser chamado em threads que tenham COM inicializado para o Single Threaded Apartment. Isso pode ser obtido chamando a CoInitialize da API COM; quando o supplicante tiver terminado com o thread STA CoUninitialize deve ser chamado antes de sair.
Sintaxe
DWORD EapHostPeerInvokeInteractiveUI(
[in] HWND hwndParent,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError
);
Parâmetros
[in] hwndParent
O identificador da janela pai na qual a caixa de diálogo de configuração é exibida.
[in] dwSizeofUIContextData
O tamanho, em bytes, do buffer apontado pelo parâmetro pUIContextData .
[in] pUIContextData
Um ponteiro para um buffer que contém os dados de contexto de interface do usuário suplicantes do EAPHost. Os dados de contexto são retornados por EapHostPeerGetUIContext. O buffer é de tamanho dwSizeOfUIContextData.
[out] pdwSizeOfDataFromInteractiveUI
Um ponteiro para um DWORD que representa o tamanho, em bytes, do buffer apontado pelo parâmetro ppDataFromInteractiveUI .
[out] ppDataFromInteractiveUI
Um ponteiro para um ponteiro para um buffer de bytes que contém dados da interface do usuário interativa necessária para que a autenticação continue. O parâmetro ppDataFromInteractiveUI deve ser passado para EapHostPeerSetUIContext como o parâmetro IN pUIContextData. Depois de consumir os dados, essa memória deve ser liberada chamando EapHostPeerFreeMemory. O buffer é de tamanho pdwSizeofDataFromInteractiveUI.
[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.
Retornar valor
Nenhum
Comentários
O supplicante deve chamar EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED é retornado, o supplicante deve recorrer ao modelo tradicional de invocação da interface do usuário interativa do método chamando EapHostPeerInvokeInteractiveUI.
Se chamado, EapHostPeerInvokeInteractiveUI aciona a interface do usuário para o método EAP depois que o supplicante chama EapHostPeerGetUIContext. Isso ocorre quando uma chamada para EapHostPeerProcessReceivedPacket retorna o código de ação EapHostPeerResponseInvokeUi . EapHostPeerGetUIContext retorna o contexto de interface do usuário que o supplicante passa para EapHostPeerInvokeInteractiveUI para gerar a interface do usuário.
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 | eaphostpeerconfigapis.h |
| Biblioteca | Eappcfg.lib |
| DLL | Eappcfg.dll |
Confira também
Funções de configuração supplicante EAPHost