Método IEAPProviderConfig::Initialize (rrascfg.h)

Artigo
03/05/2024

O sistema chama o método Initialize para inicializar uma sessão de configuração de EAP com o computador especificado.

Sintaxe

HRESULT Initialize(
  LPCOLESTR pszMachineName,
  DWORD     dwEapTypeId,
  ULONG_PTR *puConnectionParam
);

Parâmetros

pszMachineName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do computador no qual configurar o EAP. O comprimento da cadeia de caracteres não é limitado.

dwEapTypeId

Especifica o EAP para o qual inicializar uma sessão de configuração.

puConnectionParam

Ponteiro para uma variável de inteiro sem sinal. No retorno bem-sucedido, o valor dessa variável identifica essa sessão de configuração.

Retornar valor

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

Se a função falhar, o valor retornado deverá ser um dos códigos a seguir.

Código de retorno	Descrição
E_FAIL	Erro não específico.
E_INVALIDARG	Um dos argumentos é inválido.
E_OUTOFMEMORY	O método falhou porque não foi possível alocar a memória necessária.
E_UNEXPECTED	Erro inesperado.

Comentários

A interface do usuário de configuração deve permitir que o usuário configure o provedor EAP em um computador remoto. Estabeleça a conexão com o computador remoto durante a chamada para Inicializar.

A DLL que implementa IEAPProviderConfig pode dar suporte a mais de um protocolo de autenticação. O parâmetro dwEapTypeId especifica o protocolo de autenticação para o qual inicializar uma sessão de configuração.

Requisitos

Requisito	Valor
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	rrascfg.h