Função RasEapInvokeInteractiveUI (raseapif.h)

Artigo
08/25/2023

O gerenciador de conexões RAS chama a função RasEapInvokeInteractiveUI para exibir uma caixa de diálogo para obter dados de autenticação do usuário.

Sintaxe

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Parâmetros

[in] dwEapTypeId

Especifica o protocolo de autenticação para o qual invocar a interface do usuário interativa.

[in] hwndParent

Manipule para a janela pai da caixa de diálogo.

[in] pUIContextData

Ponteiro para dados de contexto para a interface do usuário interativa. O protocolo de autenticação fornece um ponteiro para esses dados como membro da estrutura PPP_EAP_OUTPUT . O Gerenciador de Conexões RAS recebe a estrutura PPP_EAP_OUTPUT como um parâmetro de saída da função RasEapMakeMessage.

[in] dwSizeOfUIContextData

Especifica o tamanho dos dados de contexto. O protocolo de autenticação fornece o tamanho como membro da estrutura PPP_EAP_OUTPUT . O Gerenciador de Conexões RAS recebe a estrutura PPP_EAP_OUTPUT como um parâmetro de saída da função RasEapMakeMessage.

ppDataFromInteractiveUI

[out[ Ponteiro para uma variável de ponteiro. No retorno bem-sucedido, essa variável de ponteiro aponta para um buffer de memória que contém os dados obtidos pela interface do usuário interativa. A interface do usuário interativa aloca essa memória. O RAS passa esses dados de volta para o protocolo de autenticação na estrutura PPP_EAP_INPUT e, em seguida, o RAS libera essa memória chamando RasEapFreeMemory.

Se a interface do usuário interativa não obtiver dados específicos do usuário, o ponteiro para o qual ppUserData aponta deverá ser definido como NULL.

[out] pdwSizeOfDataFromInteractiveUI

Ponteiro para uma variável DWORD que recebe o tamanho dos dados retornados da interface do usuário interativa. Se a interface do usuário interativa não obtiver dados específicos do usuário, a variável DWORD deverá ser definida como zero.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR. Verifique os parâmetros ppDataFromInteractiveUI e lpdwSizeOfDataFromInteractiveUI para determinar se a função retornou dados da interface do usuário interativa.

Se a função não puder alocar memória para os dados, o valor retornado deverá ser ERROR_NOT_ENOUGH_MEMORY.

Se a função falhar de alguma outra forma, o valor retornado deverá ser um código de erro apropriado de Winerror.h, Raserror.h ou Mprerror.h.

Comentários

A DLL que implementa as funções RasEapInvokeInteractiveUI e RasEapFreeMemory pode dar suporte a mais de um protocolo de autenticação. O parâmetro dwEapTypeId especifica o protocolo de autenticação para o qual invocar a interface do usuário interativa.

Um ponteiro para os dados retornados da interface do usuário interativa é passado de volta para o protocolo de autenticação no membro pDataFromInteractiveUI da estrutura PPP_EAP_INPUT . A estrutura PPP_EAP_INPUT é passada como um parâmetro para a função RasEapMakeMessage .

A interface do usuário interativa deve dar suporte a mensagens WM_COMMAND em que LOWORD(wParam) é igual a IDCANCEL.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	raseapif.h