PRADIUS_EXTENSION_PROCESS_EX fonction de rappel (authif.h)

Article
08/22/2023

Note Le service d’authentification Internet (IAS) a été renommé serveur de stratégie réseau (NPS) à partir de Windows Server 2008. Le contenu de cette rubrique s’applique à IAS et NPS. Tout au long du texte, NPS est utilisé pour faire référence à toutes les versions du service, y compris les versions initialement appelées IAS.

La fonction RadiusExtensionProcessEx est une fonction définie par l’application et est appelée par NPS pour chaque paquet d’authentification ou de comptabilité que NPS reçoit du serveur d’accès réseau (NAS). Cette fonction est similaire à RadiusExtensionProcess. Toutefois, RadiusExtensionProcessEx permet à la DLL d’extension d’ajouter des attributs à la réponse d’authentification.

Syntaxe

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

DWORD PradiusExtensionProcessEx(
  [in]  const RADIUS_ATTRIBUTE *pInAttrs,
  [out] PRADIUS_ATTRIBUTE *pOutAttrs,
  [out] PRADIUS_ACTION pfAction
)
{...}

Paramètres

[in] pInAttrs

Pointeur vers un tableau d’attributs de la requête. Le tableau est terminé par un attribut avec dwAttrType défini sur ratMinimum. Ces attributs doivent être traités en lecture seule ; Ils ne doivent pas être modifiés par RadiusExtensionProcessEx. En outre, ces attributs ne doivent être référencés d’aucune façon après les retours radiusExtensionProcessEx .

[out] pOutAttrs

Pointeur vers un tableau d’attributs fourni par la DLL d’extension NPS. Le tableau est terminé par un attribut avec dwAttrType défini sur ratMinimum. NPS ajoute ces attributs à la réponse d’authentification.

La DLL d’extension NPS alloue la mémoire pour le tableau d’attributs. NPS appelle RadiusExtensionFreeAttributes pour libérer la mémoire occupée par le tableau d’attributs.

[out] pfAction

Pointeur vers une valeur de type RADIUS_ACTION, initialement définie sur raContinue. Ce paramètre spécifie l’action que NPS doit effectuer en réponse à une demande d’accès.

Valeur retournée

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

Si la fonction échoue, la valeur de retour doit être un code d’erreur approprié de WinError.h.

Remarques

Si la valeur de retour est autre que NO_ERROR, NPS ignore la demande.

NPS prend en charge plusieurs DLL d’extension. NPS appelle RadiusExtensionProcessEx pour chacune des DLL répertoriées dans le Registre. Pour plus d’informations, consultez Configuration des DLL d’extension.

NPS appelle RadiusExtensionFreeAttributes pour libérer la mémoire occupée par le tableau d’attributs retourné par RadiusExtensionProcessEx. Pour cette raison, si vous implémentez RadiusExtensionProcessEx, vous devez également implémenter RadiusExtensionFreeAttributes.

Pour plus d’informations sur l’utilisation de cette fonction, consultez Processus d’extensions NPS.

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	authif.h