Função EapMethodAuthenticatorInvokeConfigUI (eapmethodauthenticatorapis.h)

  • Artigo

Define uma função que aciona a caixa de diálogo da interface do usuário de configuração de conexão do método EAP no cliente.

EapMethodAuthenticatorInvokeConfigUI é um protótipo de função.

EapHostAuthenticatorInvokeConfigUI 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 EapMethodAuthenticatorInvokeConfigUI(
  [in]  EAP_METHOD_TYPE *pEapMethodType,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwFlags,
  [in]  LPCWSTR         pwszMachineName,
  [in]  DWORD           dwSizeOfConfigIn,
  [in]  BYTE            *pConfigIn,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_ERROR       **ppEapError
);

Parâmetros

[in] pEapMethodType

Um ponteiro para 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] hwndParent

Um identificador para a janela pai que iniciará a caixa de diálogo de interface do usuário de configuração de conexão.

[in] dwFlags

Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.

[in] pwszMachineName

O nome do computador de destino que está sendo configurado. NULL significa que o computador local está sendo configurado.

[in] dwSizeOfConfigIn

Especifica o tamanho, em bytes, de pConfigIn. Pode ser definido como 0.

[in] pConfigIn

Um ponteiro para um buffer de bytes que contém elementos de configuração. O buffer é de tamanho dwSizeOfConfigIn. Esse parâmetro poderá ser NULL se dwSizeOfConfigIn estiver definido como 0.

[out] pdwSizeOfConfigOut

Especifica o tamanho, em bytes, dos dados de configuração retornados em ppConfigOut.

[out] ppConfigOut

Um ponteiro para um ponteiro para um buffer de bytes que contém dados de configuração atualizados do usuário. Depois de consumir os dados, essa memória deve ser liberada chamando EapMethodAuthenticatorFreeMemory.

[out] ppEapError

Um ponteiro para o endereço de uma estrutura 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 EapMethodAuthenticatorFreeErrorMemory.

Valor retornado

Nenhum

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 eapmethodauthenticatorapis.h

Confira também

Funções do método Authenticator EAPHost