Compartilhar via


Função EapPeerGetUIContext (eapmethodpeerapis.h)

Obtém o contexto da interface do usuário do método EAP. Essa função é sempre seguida pela função EapPeerInvokeInteractiveUI , que é seguida pela função EapPeerSetUIContext .

Sintaxe

DWORD EapPeerGetUIContext(
  [in]  EAP_SESSION_HANDLE sessionHandle,
  [out] DWORD              *pdwSizeOfUIContextData,
  [out] BYTE               **ppUIContextData,
  [out] EAP_ERROR          **ppEapError
);

Parâmetros

[in] sessionHandle

Um ponteiro para uma estrutura EAP_SESSION_HANDLE que contém o identificador exclusivo para esta sessão de autenticação EAP no servidor EAPHost. Esse identificador é retornado no parâmetro pSessionHandle em uma chamada anterior para EapPeerBeginSession.

[out] pdwSizeOfUIContextData

Um ponteiro para um valor que especifica o tamanho do buffer de bytes de dados de contexto da interface do usuário retornado em ppUIContextData.

[out] ppUIContextData

Um ponteiro para um endereço que contém um buffer de bytes com os dados de contexto de interface do usuário suplicantes do EAPHost.

[out] ppEapError

Um ponteiro para o endereço de 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 passando um ponteiro para os dados de erro para EapPeerFreeErrorMemory.

Retornar valor

Nenhum

Comentários

EapPeerGetUIContext é chamado por EAPHost quando uma chamada anterior indica que um contexto de interface do usuário está disponível.

Essa chamada é executada por um EAPHost baseado em pares usando um ponteiro de função para essa API. Essa API deve ser implementada no método EAP carregado pelo EAPHost e deve estar estritamente em conformidade com a sintaxe e os tipos de parâmetro especificados na documentação.

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

Confira também

Funções de Run-Time de método par EAPHost

EapPeerInvokeInteractiveUI

EapPeerSetUIContext