Partager via


RADIUS_ATTRIBUTE_ARRAY structure (authif.h)

Note Le service d’authentification Internet (IAS) a été renommé serveur NPS (Network Policy Server) à compter de Windows Server 2008. Le contenu de cette rubrique s’applique à la fois à 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 structure RADIUS_ATTRIBUTE_ARRAY représente un tableau d’attributs.

Syntaxe

typedef struct _RADIUS_ATTRIBUTE_ARRAY {
  DWORD                  cbSize;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This, const RADIUS_ATTRIBUTE *pAttr)                 * )Add;
  const RADIUS_ATTRIBUTE  )(const _RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex) *(*AttributeAt;
  DWORD()(const _RADIUS_ATTRIBUTE_ARRAY *This)                 * GetSize;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex, const RADIUS_ATTRIBUTE *pAttr)                 * )InsertAt;
  DWORD()(_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex)                 * RemoveAt;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex, const RADIUS_ATTRIBUTE *pAttr)                 * )SetAt;
} RADIUS_ATTRIBUTE_ARRAY, *PRADIUS_ATTRIBUTE_ARRAY;

Membres

cbSize

Spécifie la taille de la structure.

Add

Pointeur vers la fonction Add fournie par NPS. NPS définit la valeur du membre.

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs auquel ajouter l’attribut spécifié.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

pAttr

Pointeur vers une structure RADIUS_ATTRIBUTE pour l’attribut à ajouter au tableau.

AttributeAt

Pointeur vers la fonction AttributeAt fournie par NPS. NPS définit la valeur du membre.

La fonction AttributeAt retourne un pointeur const vers l’attribut spécifié dans le tableau.

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs à partir duquel récupérer l’attribut spécifié.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

dwIndex

Spécifie l’index de l’attribut à récupérer. La fonction retourne NULL si cet index est hors plage.

Utilisez la fonction GetSize pour déterminer la taille du tableau. Le plus grand index est inférieur à la taille du tableau.

GetSize

Pointeur vers la fonction GetSize fournie par NPS. NPS définit la valeur du membre.

La fonction GetSize retourne la taille du tableau d’attributs.

La fonction GetSize retourne la taille du tableau d’attributs, et non le plus grand index. Étant donné que les tableaux d’attributs utilisent des index de base zéro, la taille du tableau est supérieure à l’index le plus grand.

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs pour lequel récupérer la taille.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

InsertAt

Pointeur vers la fonction InsertAt fournie par NPS. NPS définit la valeur du membre.

La fonction InsertAt insère l’attribut spécifié à l’index spécifié dans le tableau.

Lorsque la fonction InsertAt insère un nouvel attribut dans le tableau, elle incrémente l’index de l’attribut préexistant à cet index. De même, il incrémente l’index de tous les attributs préexistants à des index plus élevés.

Pour ajouter un attribut à la fin du tableau d’attributs, utilisez la fonction Add .

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs dans lequel insérer l’attribut spécifié.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

dwIndex

Spécifie l’index auquel insérer l’attribut spécifié.

Utilisez la fonction GetSize pour déterminer la taille du tableau. Le plus grand index est inférieur à la taille du tableau.

pAttr

Pointeur vers une structure RADIUS_ATTRIBUTE pour l’attribut à insérer dans le tableau.

RemoveAt

Pointeur vers la fonction RemoveAt fournie par NPS. NPS définit la valeur du membre.

La fonction RemoveAt supprime l’attribut à l’index spécifié dans le tableau.

Lorsque la fonction RemoveAt supprime un attribut du tableau, elle décrémente l’index de tous les attributs préexistants à des index plus élevés.

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs à partir duquel supprimer l’attribut spécifié.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

dwIndex

Spécifie l’index de l’attribut à supprimer.

Utilisez la fonction GetSize pour déterminer la taille du tableau. Le plus grand index est inférieur à la taille du tableau.

SetAt

Pointeur vers la fonction SetAt fournie par NPS. NPS définit la valeur du membre.

La fonction SetAt remplace l’attribut à l’index spécifié par l’attribut spécifié.

Cette

Pointeur vers la structure RADIUS_ATTRIBUTE_ARRAY qui représente le tableau d’attributs qui contient l’attribut à remplacer.

Les fonctions GetRequest et GetResponse retournent des pointeurs vers RADIUS_ATTRIBUTE_ARRAY structures.

dwIndex

Spécifie l’index de l’attribut à remplacer.

Utilisez la fonction GetSize pour déterminer la taille du tableau. Le plus grand index est inférieur à la taille du tableau.

pAttr

Pointeur vers une structure RADIUS_ATTRIBUTE . L’attribut représenté par cette structure remplace l’attribut à l’index spécifié.

Remarques

La DLL d’extension ne doit pas modifier cette structure. Les modifications apportées au tableau d’attributs doivent être effectuées en appelant les fonctions fournies en tant que membres de cette structure.

Cette structure est utilisée par les DLL d’extension qui exportent RadiusExtensionProcess2. Fonctions qui ajoutent des attributs au tableau :

AjouterInsertAt copiez le contenu de la structure RADIUS_ATTRIBUTE fournie par l’appelant. Par conséquent, les DLL d’extension qui exportent RadiusExtensionProcess2 n’ont pas besoin d’exporter RadiusExtensionFreeAttributes.

Cette structure est retournée par les fonctions GetRequest et GetResponse.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008
En-tête authif.h

Voir aussi

À propos des extensions NPS

Informations de référence sur les extensions NPS

Structures d’extensions NPS

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2