структура RADIUS_ATTRIBUTE_ARRAY (authif.h)

Статья
02/28/2024

Примечание Служба проверки подлинности в Интернете (IAS) была переименована в сервер политики сети (NPS), начиная с Windows Server 2008. Содержание этого раздела относится как к IAS, так и к NPS. В тексте NPS используется для обозначения всех версий службы, включая версии, первоначально называемые IAS.

Структура RADIUS_ATTRIBUTE_ARRAY представляет массив атрибутов.

Синтаксис

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;

Члены

cbSize

Задает размер структуры.

Add

Указатель на функцию Add , предоставляемую NPS. NPS задает значение члена.

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, к которому добавляется указанный атрибут.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

pAttr

Указатель на структуру RADIUS_ATTRIBUTE атрибута, добавляемого в массив.

AttributeAt

Указатель на функцию AttributeAt , предоставляемую NPS. NPS задает значение члена.

Функция AttributeAt возвращает константный указатель на указанный атрибут в массиве.

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, из которого извлекается указанный атрибут.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

DwIndex

Указывает индекс извлекаемого атрибута. Функция возвращает значение NULL , если этот индекс выходит за пределы диапазона.

Используйте функцию GetSize для определения размера массива. Самый большой индекс на один меньше размера массива.

GetSize

Указатель на функцию GetSize , предоставляемую NPS. NPS задает значение члена.

Функция GetSize возвращает размер массива атрибутов.

Функция GetSize возвращает размер массива атрибутов, а не самый большой индекс. Так как массивы атрибутов используют индексы с нуля, размер массива на единицу больше, чем самый большой индекс.

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, для которых требуется получить размер.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

InsertAt

Указатель на функцию InsertAt , предоставляемую NPS. NPS задает значение члена.

Функция InsertAt вставляет указанный атрибут по указанному индексу в массив.

Когда функция InsertAt вставляет новый атрибут в массив, она увеличивает индекс существующего атрибута по этому индексу. Аналогичным образом он увеличивает индекс всех ранее существующих атрибутов по более высоким индексам.

Чтобы добавить атрибут в конец массива атрибутов, используйте функцию Добавить .

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, в который вставляется указанный атрибут.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

DwIndex

Указывает индекс, по которому вставляется указанный атрибут.

pAttr

Указатель на структуру RADIUS_ATTRIBUTE для атрибута для вставки в массив.

RemoveAt

Указатель на функцию RemoveAt , предоставляемую NPS. NPS задает значение члена.

Функция RemoveAt удаляет атрибут по указанному индексу в массиве.

Когда функция RemoveAt удаляет атрибут из массива, она уменьшает индекс всех ранее существующих атрибутов по более высоким индексам.

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, из которого удаляется указанный атрибут.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

DwIndex

Указывает индекс удаляемого атрибута.

SetAt

Указатель на функцию SetAt , предоставляемую NPS. NPS задает значение члена.

Функция SetAt заменяет атрибут по указанному индексу указанным атрибутом.

This

Указатель на структуру RADIUS_ATTRIBUTE_ARRAY , представляющую массив атрибутов, содержащий атрибут для замены.

Функции GetRequest и GetResponse возвращают указатели на RADIUS_ATTRIBUTE_ARRAY структуры.

DwIndex

Указывает индекс заменяемого атрибута.

pAttr

Указатель на структуру RADIUS_ATTRIBUTE . Атрибут, представленный этой структурой, заменяет атрибут по указанному индексу.

Библиотека DLL расширения не должна изменять эту структуру. Изменения в массив атрибутов следует вносить путем вызова функций, предоставленных в качестве членов этой структуры.

Эта структура используется библиотеками DLL расширений, которые экспортируют RadiusExtensionProcess2. Функции, которые добавляют атрибуты в массив:

Добавить InsertAt копировать содержимое структуры RADIUS_ATTRIBUTE, предоставленной вызывающим элементом. Поэтому библиотеки DLL расширений, которые экспортируют RadiusExtensionProcess2 , не должны экспортировать radiusExtensionFreeAttributes.

Эта структура возвращается функциями GetRequest и GetResponse.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008
Верхняя часть	authif.h