Fonction RasEapInvokeConfigUI (raseapif.h)

Article
08/25/2023

Le gestionnaire de connexions RAS appelle la fonction RasEapInvokeConfigUI pour afficher une boîte de dialogue afin d’obtenir des informations de configuration de l’utilisateur. RAS appelle RasEapInvokeConfigUI lorsqu’une nouvelle entrée d’annuaire téléphonique est créée ou qu’une entrée d’annuaire téléphonique existante est modifiée, à condition que le protocole d’authentification de l’entrée fournisse une interface utilisateur de configuration.

Syntaxe

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Paramètres

[in] dwEapTypeId

Spécifie le protocole d’authentification pour lequel appeler l’interface utilisateur de configuration.

[in] hwndParent

Gérez vers la fenêtre parente pour la boîte de dialogue d’interface utilisateur.

[in] dwFlags

Spécifie zéro ou plusieurs des indicateurs suivants qui qualifient le processus d’authentification.

Indicateur	Signification
RAS_EAP_FLAG_ROUTER	Spécifie que l’ordinateur qui compose est un routeur. L’absence de cet indicateur indique que l’ordinateur qui compose est un client RAS.
RAS_EAP_FLAG_8021X_AUTH	Spécifie que cette session s’exécute dans un contexte sans fil.
RAS_EAP_FLAG_GUEST_ACCESS	Spécifié si le client souhaite l’accès invité. Cet indicateur est normalement utilisé dans le cas d’une connexion sans fil, de sorte que si l’authentification échoue pour N nombre d’essais consécutifs, le client sans fil, s’il est configuré pour demander l’accès invité, le fait en passant cet indicateur. Le serveur RADIUS doit être configuré pour autoriser l’accès invité.

[in] pConnectionDataIn

Pointeur vers les données de connexion actuellement stockées dans l’entrée de l’annuaire téléphonique. Si l’entrée de l’annuaire téléphonique ne contient aucune donnée, ce paramètre est NULL.

[in] dwSizeOfConnectionDataIn

Spécifie la taille des données de connexion actuellement stockées dans l’entrée de l’annuaire téléphonique. Si l’entrée de l’annuaire téléphonique pour cette connexion ne contient aucune donnée, ce paramètre est égal à zéro.

[out] ppConnectionDataOut

Pointeur vers un pointeur qui, en cas de retour réussi, pointe vers les nouvelles données de connexion à stocker dans l’entrée de l’annuaire téléphonique. Aucune de ces données ne doit être spécifique à l’ordinateur actuel ; Les entrées de l’annuaire téléphonique doivent être portables d’une machine à l’autre.

[out] pdwSizeOfConnectionDataOut

Pointeur vers un DWORD qui reçoit la taille des nouvelles données de connexion à stocker dans l’entrée de l’annuaire téléphonique.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction n’a pas pu allouer de mémoire pour les données de configuration, la valeur de retour doit être ERROR_NOT_ENOUGH_MEMORY.

Si la fonction échoue d’une autre manière, la valeur de retour doit être un code d’erreur approprié de Winerror.h, Raserror.h ou Mprerror.h.

Notes

La DLL qui implémente RasEapInvokeConfigUI et RasEapFreeMemory peut prendre en charge plusieurs protocoles d’authentification. Le paramètre dwEapTypeId spécifie pour quel protocole appeler l’interface utilisateur de configuration.

RAS stocke les données de connexion retournées par RasEapInvokeConfigUI dans l’entrée de l’annuaire téléphonique pour la connexion sur l’ordinateur client.

Spécifications


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