RasGetEapUserIdentityA, fonction (ras.h)

Article
11/20/2024

La fonction RasGetEapUserIdentity récupère les informations d’identité de l’utilisateur actuel. Utilisez ces informations pour appeler RasDial avec une entrée de carnet téléphonique qui nécessite le protocole EAP (Extensible Authentication Protocol).

Syntaxe

DWORD RasGetEapUserIdentityA(
  [in]  LPCSTR                pszPhonebook,
  [in]  LPCSTR                pszEntry,
  [in]  DWORD                 dwFlags,
  [in]  HWND                  hwnd,
  [out] LPRASEAPUSERIDENTITYA *ppRasEapUserIdentity
);

Paramètres

[in] pszPhonebook

Pointeur vers une chaîne null-terminated qui spécifie le chemin d’accès complet du fichier PBK (Phone-Book). Si ce paramètre est NULL, la fonction utilise le carnet de téléphones système.

[in] pszEntry

Pointeur vers une chaîne null-terminated qui spécifie un nom d’entrée existant.

[in] dwFlags

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

Drapeau	Signification
RASEAPF_NonInteractive	Spécifie que le protocole d’authentification ne doit pas afficher une interface utilisateur graphique. Si cet indicateur n’est pas présent, il est acceptable que le protocole affiche une interface utilisateur.
RASEAPF_Logon	Spécifie que les données utilisateur sont obtenues à partir de WinLogon.
RASEAPF_Preview	Spécifie que l’utilisateur doit être invité à entrer des informations d’identité avant de composer.

[in] hwnd

Gérez la fenêtre parente de la boîte de dialogue d’interface utilisateur. Si le paramètre fInvokeUI est FALSE, hwnd doit être NULL .

[out] ppRasEapUserIdentity

Pointeur vers un pointeur qui, lors d’un retour réussi, reçoit l’adresse de la structure RASEAPUSERIDENTITY qui contient les informations d’identité utilisateur EAP. RasGetEapUserIdentity alloue la mémoire tampon pour la structure RASEAPUSERIDENTITY. Libérez cette mémoire en appelant RasFreeEapUserIdentity.

Valeur de retour

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

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur de Codes d’erreur d’acheminement et d’accès à distance ou Winerror.h.

Valeur	Signification
E_INVALID_ARG	Le paramètre NULL est.
ERROR_INTERACTIVE_MODE	La fonction a été appelée avec l’indicateur RASEAPF_NonInteractive. Toutefois, le protocole d’authentification doit afficher une interface utilisateur pour obtenir les informations d’identité requises auprès de l’utilisateur.
ERROR_INVALID_FUNCTION_FOR_ENTRY	La méthode d’authentification pour cette entrée de carnet téléphonique n’est pas EAP, ou la méthode d’authentification est EAP, mais le protocole utilise la boîte de dialogue d’informations d’identification Windows NT/Windows 2000 standard pour obtenir des informations d’identité utilisateur. Dans les deux cas, l’appelant n’a pas besoin de transmettre les informations d’identité EAP à RasDial.
ERROR_RASMAN_CANNOT_INITIALIZE	Le service d’accès à distance n’a pas pu s’initialiser correctement.
autres	Utilisez formatMessage pour récupérer le message d’erreur système correspondant au code d’erreur retourné.

Remarques

RasGetEapUserIdentity appelle la fonction RAS RasGetEapUserData et la fonction EAP RasEapGetIdentity. RasEapGetIdentity est implémenté par le protocole d’authentification.

Si la fonction réussit, c’est-à-dire que la valeur de retour est NO_ERROR, l’appelant doit copier les informations d’identité EAP à partir de la structure RASEAPUSERIDENTITY pointée par le paramètre ppRasEapUserIdentity RASDIALPARAMS et structures RASDIALEXTENSIONS utilisées dans l’appel à RasDial.

Si l’application d’accès à distance en cours de développement a une interface utilisateur graphique, l’appelant de RasGetEapUserIdentity ne doit pas spécifier l’indicateur de RASEAPF_NonInteractive. Si l’application a une interface utilisateur de ligne de commande, l’appelant peut spécifier l’indicateur RASEAPF_NonInteractive pour empêcher le protocole d’authentification d’afficher une interface utilisateur graphique.

Note

L’en-tête ras.h définit RasGetEapUserIdentity comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	ras.h
bibliothèque	Rasapi32.lib
DLL	Rasapi32.dll