Partager via


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

Le système appelle la méthode Initialize pour initialiser une session de configuration EAP avec l’ordinateur spécifié.

Syntaxe

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

Paramètres

pszMachineName

Pointeur vers une chaîne terminée par null qui contient le nom de l’ordinateur sur lequel configurer EAP. La longueur de chaîne n’est pas limitée.

dwEapTypeId

Spécifie l’EAP pour lequel initialiser une session de configuration.

puConnectionParam

Pointeur vers une variable entière non signée. En cas de retour réussi, la valeur de cette variable identifie cette session de configuration.

Valeur retournée

Si la fonction réussit, la valeur de retour doit être S_OK.

Si la fonction échoue, la valeur de retour doit être l’un des codes suivants.

Code de retour Description
E_FAIL
Erreur non spécifique.
E_INVALIDARG
L’un des arguments n’est pas valide.
E_OUTOFMEMORY
La méthode a échoué, car elle n’a pas pu allouer la mémoire requise.
E_UNEXPECTED
Une erreur inattendue s’est produite.

Remarques

L’interface utilisateur de configuration doit permettre à l’utilisateur de configurer le fournisseur EAP sur un ordinateur distant. Établissez la connexion à l’ordinateur distant pendant l’appel à Initialize.

La DLL qui implémente IEAPProviderConfig peut prendre en charge plusieurs protocoles d’authentification. Le paramètre dwEapTypeId spécifie le protocole d’authentification pour lequel initialiser une session de configuration.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rrascfg.h

Voir aussi

Interfaces d’EAP

Informations de référence sur le protocole d’authentification extensible

IEAPProviderConfig

IEAPProviderConfig ::RouterInvokeConfigUI

IEAPProviderConfig ::RouterInvokeCredentialsUI

IEAPProviderConfig ::ServerInvokeConfigUI

IEAPProviderConfig ::Uninitialize