Função EapHostPeerInvokeIdentityUI (eaphostpeerconfigapis.h)

Artigo
02/29/2024

Essa função é chamada por métodos de túnel para invocar a interface do usuário de identidade dos métodos internos. Essa função retorna a identidade, bem como as credenciais a serem usadas para iniciar a autenticação.

Sintaxe

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] LPVOID          *ppvReserved
);

Parâmetros

[in] dwVersion

O número de versão da API. Deve ser definido como zero.

[in] eapMethodType

Uma estrutura EAP_METHOD_TYPE que especifica o tipo de autenticação EAP a ser usada para esta sessão.

[in] dwFlags

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

[in] hwndParent

Identificador da janela pai na qual a caixa de diálogo de configuração será exibida.

[in] dwSizeofConnectionData

Tamanho do buffer indicado pelo parâmetro pConnectionData , em bytes.

[in] pConnectionData

Ponteiro para dados de configuração usados para o método EAP.

[in] dwSizeofUserData

Tamanho do buffer indicado pelo parâmetro pUserData , em bytes.

[in] pUserData

Ponteiro para informações de credencial do usuário que pertencem a essa autenticação.

[in, out] pdwSizeOfUserDataOut

Tamanho do conjunto de buffers para receber os dados do usuário retornados pelo parâmetro ppUserDataOut , em bytes.

[out] ppUserDataOut

Um ponteiro para um ponteiro para um buffer que contém informações de dados do usuário retornadas pelo método . Após o uso, essa memória deve ser liberada chamando EapHostPeerFreeMemory.

[out] ppwszIdentity

Um ponteiro para uma cadeia de caracteres de identidade do usuário terminada em NULL. Após o uso, essa memória deve ser liberada chamando EapHostPeerFreeMemory.

[out] ppEapError

Um ponteiro para um ponteiro para 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 EapHostPeerFreeErrorMemory.

[in, out] ppvReserved

Reservado para uso futuro.

Retornar valor

Nenhum

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

Compartilhar via