Compartilhar via


Função EapHostPeerGetIdentity (eappapis.h)

Essa função é chamada por métodos de túnel para solicitar informações de identidade dos métodos internos. Essa função retorna as informações de identidade e credencial do usuário.

Sintaxe

DWORD EapHostPeerGetIdentity(
  [in]      DWORD           dwVersion,
  [in]      DWORD           dwFlags,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in]      HANDLE          hTokenImpersonateUser,
  [out]     BOOL            *pfInvokeUI,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] BYTE            **ppvReserved
);

Parâmetros

[in] dwVersion

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

[in] dwFlags

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

[in] eapMethodType

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

[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 sessão de autenticação.

[in] hTokenImpersonateUser

Token de representação para um usuário conectado coletar informações relacionadas ao usuário.

[out] pfInvokeUI

Retorna TRUE se a identidade do usuário e o blob de dados do usuário não forem retornados com êxito e o método buscar coletar as informações do usuário por meio da caixa de diálogo interface do usuário.

[in, out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

Informações de dados do usuário retornadas pelo método . Após o uso, essa memória deve ser liberada chamando EapHostPeerFreeRuntimeMemory.

[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 EapHostPeerFreeRuntimeMemory.

[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

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 eappapis.h
Biblioteca Eappprxy.lib
DLL Eapphost.dll

Confira também

Funções de Run-Time Supplicante EAPHost

EapHostPeerGetUIContext