EapPeerGetUIContext, fonction (eapmethodpeerapis.h)
Obtient le contexte de l’interface utilisateur à partir de la méthode EAP. Cette fonction est toujours suivie de la fonction EapPeerInvokeInteractiveUI , qui est suivie de la fonction EapPeerSetUIContext .
Syntaxe
DWORD EapPeerGetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
Paramètres
[in] sessionHandle
Pointeur vers une structure de EAP_SESSION_HANDLE qui contient le handle unique de cette session d’authentification EAP sur le serveur EAPHost. Ce handle est retourné dans le paramètre pSessionHandle d’un appel précédent à EapPeerBeginSession.
[out] pdwSizeOfUIContextData
Pointeur vers une valeur qui spécifie la taille de la mémoire tampon d’octets de données de contexte de l’interface utilisateur retournée dans ppUIContextData.
[out] ppUIContextData
Pointeur vers une adresse qui contient une mémoire tampon d’octets avec les données de contexte de l’interface utilisateur de la requête d’EAPHost.
[out] ppEapError
Pointeur vers l’adresse d’une structure de EAP_ERROR qui contient les erreurs générées pendant l’exécution de cet appel de fonction. Après avoir consommé les données d’erreur, cette mémoire doit être libérée en passant un pointeur vers les données d’erreur vers EapPeerFreeErrorMemory.
Valeur de retour
None
Remarques
EapPeerGetUIContext est appelé par EAPHost lorsqu’un appel précédent indique qu’un contexte d’interface utilisateur est disponible.
Cet appel est effectué par un EAPHost basé sur un homologue à l’aide d’un pointeur de fonction vers cette API. Cette API doit être implémentée sur la méthode EAP chargée par EAPHost et doit strictement être conforme aux types de syntaxe et de paramètres spécifiés dans la documentation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | eapmethodpeerapis.h |