RADIUS_ATTRIBUTE_ARRAY structure (authif.h)
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
Informations de référence sur les extensions NPS