RasEapInvokeInteractiveUI, fonction (raseapif.h)

Article
08/25/2023

Le gestionnaire de connexions RAS appelle la fonction RasEapInvokeInteractiveUI pour afficher une boîte de dialogue afin d’obtenir des données d’authentification de l’utilisateur.

Syntaxe

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Paramètres

[in] dwEapTypeId

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

[in] hwndParent

Gérez la fenêtre parente pour la boîte de dialogue.

[in] pUIContextData

Pointeur vers les données de contexte pour l’interface utilisateur interactive. Le protocole d’authentification fournit un pointeur vers ces données en tant que membre de la structure PPP_EAP_OUTPUT . Le Gestionnaire des connexions RAS reçoit la structure PPP_EAP_OUTPUT en tant que paramètre de sortie de la fonction RasEapMakeMessage.

[in] dwSizeOfUIContextData

Spécifie la taille des données de contexte. Le protocole d’authentification fournit la taille en tant que membre de la structure PPP_EAP_OUTPUT . Le Gestionnaire des connexions RAS reçoit la structure PPP_EAP_OUTPUT en tant que paramètre de sortie de la fonction RasEapMakeMessage.

ppDataFromInteractiveUI

[out[ Pointeur vers une variable pointeur. En cas de retour réussi, cette variable pointeur pointe vers une mémoire tampon qui contient les données obtenues par l’interface utilisateur interactive. L’interface utilisateur interactive alloue cette mémoire. RAS transmet ces données au protocole d’authentification dans la structure PPP_EAP_INPUT , puis RAS libère cette mémoire en appelant RasEapFreeMemory.

Si l’interface utilisateur interactive n’obtient pas de données spécifiques à l’utilisateur, le pointeur vers lequel ppUserData pointe doit avoir la valeur NULL.

[out] pdwSizeOfDataFromInteractiveUI

Pointeur vers une variable DWORD qui reçoit la taille des données retournées par l’interface utilisateur interactive. Si l’interface utilisateur interactive n’obtient pas de données spécifiques à l’utilisateur, la variable DWORD doit être définie sur zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR. Vérifiez les paramètres ppDataFromInteractiveUI et lpdwSizeOfDataFromInteractiveUI pour déterminer si la fonction a retourné des données à partir de l’interface utilisateur interactive.

Si la fonction n’a pas pu allouer de mémoire pour les données, 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 les fonctions RasEapInvokeInteractiveUI et RasEapFreeMemory peut prendre en charge plusieurs protocoles d’authentification. Le paramètre dwEapTypeId spécifie le protocole d’authentification pour lequel appeler l’interface utilisateur interactive.

Un pointeur vers les données retournées par l’interface utilisateur interactive est repassé au protocole d’authentification dans le membre pDataFromInteractiveUI de PPP_EAP_INPUT structure. La structure PPP_EAP_INPUT est passée en tant que paramètre à la fonction RasEapMakeMessage .

L’interface utilisateur interactive doit prendre en charge WM_COMMAND messages où LOWORD(wParam) est égal à IDCANCEL.

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