EapPeerGetMethodProperties, fonction (eapmethodpeerapis.h)

Définit l’implémentation d’une fonction spécifique à une méthode EAP qui récupère les propriétés d’une méthode EAP en fonction de la connexion et des données utilisateur.

Syntaxe

DWORD EapPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwSizeOfConnectionDataIn,
  [in]  const BYTE                *pConnectionDataIn,
  [in]  DWORD                     dwSizeOfUserDataIn,
  [in]  const BYTE                *pUserDataIn,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Paramètres

[in] dwVersion

Numéro de version de l’API.

[in] dwFlags

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

[in] eapMethodType

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

[in] hUserImpersonationToken

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

[in] dwSizeOfConnectionDataIn

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

[in] pConnectionDataIn

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] dwSizeOfUserDataIn

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

[in] pUserDataIn

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 une 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 appelant EapPeerFreeErrorMemory.

Valeur de retour

None

Configuration requise

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