Função RasEapInvokeConfigUI (raseapif.h)

Artigo
08/25/2023

O gerenciador de conexões RAS chama a função RasEapInvokeConfigUI para exibir uma caixa de diálogo para obter informações de configuração do usuário. A RAS chama RasEapInvokeConfigUI quando uma nova entrada de catálogo telefônico é criada ou uma entrada de catálogo telefônico existente é editada, desde que o protocolo de autenticação para a entrada forneça uma interface do usuário de configuração.

Sintaxe

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Parâmetros

[in] dwEapTypeId

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

[in] hwndParent

Manipule para a janela pai da caixa de diálogo da interface do usuário.

[in] dwFlags

Especifica zero ou mais dos sinalizadores a seguir que qualificam o processo de autenticação.

Sinalizador	Significado
RAS_EAP_FLAG_ROUTER	Especifica que o computador que está discando em é um roteador. A ausência desse sinalizador indica que o computador discando em é um cliente RAS.
RAS_EAP_FLAG_8021X_AUTH	Especifica que esta sessão está sendo executada em um contexto sem fio.
RAS_EAP_FLAG_GUEST_ACCESS	Especificado se o cliente deseja acesso de convidado. Normalmente, esse sinalizador é usado no caso de uma conexão sem fio de modo que, se a autenticação falhar por N número de tentativas consecutivas do cliente sem fio, se configurado para solicitar acesso de convidado, faça isso passando esse sinalizador. O servidor RADIUS deve ser configurado para permitir o acesso de convidado.

[in] pConnectionDataIn

Ponteiro para os dados de conexão armazenados atualmente na entrada do catálogo telefônico. Se a entrada do catálogo telefônico não contiver dados, esse parâmetro será NULL.

[in] dwSizeOfConnectionDataIn

Especifica o tamanho dos dados de conexão atualmente armazenados na entrada do catálogo telefônico. Se a entrada do catálogo telefônico dessa conexão não contiver dados, esse parâmetro será zero.

[out] ppConnectionDataOut

Ponteiro para um ponteiro que, no retorno bem-sucedido, aponta para os novos dados de conexão a serem armazenados na entrada do catálogo telefônico. Nenhum desses dados deve ser específico para o computador atual; As entradas do catálogo telefônico devem ser portáteis de computador para computador.

[out] pdwSizeOfConnectionDataOut

Ponteiro para um DWORD que recebe o tamanho dos novos dados de conexão a serem armazenados na entrada do catálogo telefônico.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função não puder alocar memória para os dados de configuração, 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 RasEapInvokeConfigUI e RasEapFreeMemory pode dar suporte a mais de um protocolo de autenticação. O parâmetro dwEapTypeId especifica para qual protocolo invocar a interface do usuário de configuração.

O RAS armazena os dados de conexão retornados por RasEapInvokeConfigUI na entrada do catálogo telefônico para a conexão no computador cliente.

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