EapHostPeerGetMethodProperties, fonction (eaphostpeerconfigapis.h)

Article
02/29/2024

La fonction EapHostPeerGetMethodProperties permet de récupérer les propriétés d’une méthode EAP en fonction de la connexion et des données utilisateur.

Syntaxe

DWORD EapHostPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwEapConnDataSize,
  [in]  const BYTE                *pbEapConnData,
  [in]  DWORD                     dwUserDataSize,
  [in]  const BYTE                *pbUserData,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Paramètres

[in] dwVersion

Numéro de version de l’API. Définissez ce paramètre sur zéro.

[in] dwFlags

Combinaison d’indicateurs EAP qui décrivent le comportement de la session d’authentification EAP.

[in] eapMethodType

Structure EAP_METHOD_TYPE qui spécifie la méthode EAP que le demandeur doit utiliser.

[in] hUserImpersonationToken

Handle du jeton d’emprunt d’identité utilisateur à utiliser dans cette session.

[in] dwEapConnDataSize

Taille, en octets, de la mémoire tampon de données de connexion fournie dans pbEapConnData.

[in] pbEapConnData

Données de connexion utilisées pour la méthode EAP. Si la valeur est NULL, la propriété statique de la méthode, telle que configurée dans le Registre, est retournée.

[in] dwUserDataSize

Taille, en octets, de la mémoire tampon de données utilisateur fournie dans pbUserData.

[in] pbUserData

Pointeur vers une mémoire tampon d’octets qui contient l’objet BLOB de données utilisateur opaques. Ce paramètre peut être NULL.

[out] pMethodPropertyArray

Pointeur vers le tableau de propriétés de méthode EAP_METHOD_PROPERTY_ARRAY. L’appelant doit libérer les pointeurs internes à l’aide d’EapHostPeerFreeMemory en commençant par le pointeur le plus interne. L’appelant doit libérer une valeur empvString uniquement lorsque le type est empvtString.

[out] ppEapError

Pointeur vers un pointeur vers une structure de EAP_ERROR qui contient les erreurs générées par EAPHost 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 EapHostPeerFreeErrorMemory.

Valeur de retour

None

Remarques

EapHostPeerGetMethodProperties permet à l’utilisateur de récupérer les propriétés d’une méthode EAP via l’interface de requête EAPHost. Les propriétés retournées par cette API peuvent être différentes des propriétés retournées par la fonction EapHostPeerGetMethods . La fonction EapHostPeerGetMethodProperties retourne les propriétés d’une méthode EAP pour une connexion et des données utilisateur spécifiques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	eaphostpeerconfigapis.h
Bibliothèque	Eappcfg.lib
DLL	Eappcfg.dll

Voir aussi

Fonctions de configuration EAPHost Supplicant

Partager via