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

Article
03/04/2024

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