estructura RADIUS_ATTRIBUTE_ARRAY (authif.h)

Nota A partir de Windows Server 2008, se cambió el nombre del servicio de autenticación de Internet (IAS). El contenido de este tema se aplica tanto a IAS como a NPS. A lo largo del texto, NPS se usa para hacer referencia a todas las versiones del servicio, incluidas las versiones a las que se hace referencia originalmente como IAS.
 
La estructura RADIUS_ATTRIBUTE_ARRAY representa una matriz de atributos.

Sintaxis

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;

Miembros

cbSize

Especifica el tamaño de la estructura.

Add

Puntero a la función Add proporcionada por NPS. NPS establece el valor del miembro.

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos a los que se va a anexar el atributo especificado.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

pAttr

Puntero a una estructura de RADIUS_ATTRIBUTE para que el atributo se anexe a la matriz.

AttributeAt

Puntero a la función AttributeAt proporcionada por NPS. NPS establece el valor del miembro.

La función AttributeAt devuelve un puntero const al atributo especificado dentro de la matriz.

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos de los que se va a recuperar el atributo especificado.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

dwIndex

Especifica el índice del atributo que se va a recuperar. La función devuelve NULL si este índice está fuera del intervalo.

Use la función GetSize para determinar el tamaño de la matriz. El índice más grande es uno menor que el tamaño de la matriz.

GetSize

Puntero a la función GetSize proporcionada por NPS. NPS establece el valor del miembro.

La función GetSize devuelve el tamaño de la matriz de atributos.

La función GetSize devuelve el tamaño de la matriz de atributos, no el índice más grande. Dado que las matrices de atributos usan índices de base cero, el tamaño de la matriz es uno mayor que el índice más grande.

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos para los que se va a recuperar el tamaño.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

InsertAt

Puntero a la función InsertAt proporcionada por NPS. NPS establece el valor del miembro.

La función InsertAt inserta el atributo especificado en el índice especificado de la matriz.

Cuando la función InsertAt inserta un nuevo atributo en la matriz, incrementa el índice del atributo preexistente en este índice. Del mismo modo, incrementa el índice de los atributos preexistentes en índices superiores.

Para anexar un atributo al final de la matriz de atributos, use la función Add .

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos en el que se va a insertar el atributo especificado.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

dwIndex

Especifica el índice en el que se va a insertar el atributo especificado.

Use la función GetSize para determinar el tamaño de la matriz. El índice más grande es uno menor que el tamaño de la matriz.

pAttr

Puntero a una estructura de RADIUS_ATTRIBUTE para que el atributo se inserte en la matriz.

RemoveAt

Puntero a la función RemoveAt proporcionada por NPS. NPS establece el valor del miembro.

La función RemoveAt quita el atributo en el índice especificado de la matriz.

Cuando la función RemoveAt quita un atributo de la matriz, disminuye el índice de los atributos preexistentes en índices superiores.

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos de los que se va a quitar el atributo especificado.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

dwIndex

Especifica el índice del atributo que se va a quitar.

Use la función GetSize para determinar el tamaño de la matriz. El índice más grande es uno menor que el tamaño de la matriz.

SetAt

Puntero a la función SetAt proporcionada por NPS. NPS establece el valor del miembro.

La función SetAt reemplaza el atributo en el índice especificado por el atributo especificado.

Este

Puntero a la estructura RADIUS_ATTRIBUTE_ARRAY que representa la matriz de atributos que contiene el atributo que se va a reemplazar.

Las funciones GetRequest y GetResponse devuelven punteros a RADIUS_ATTRIBUTE_ARRAY estructuras.

dwIndex

Especifica el índice del atributo que se va a reemplazar.

Use la función GetSize para determinar el tamaño de la matriz. El índice más grande es uno menor que el tamaño de la matriz.

pAttr

Puntero a una estructura de RADIUS_ATTRIBUTE . El atributo representado por esta estructura reemplaza el atributo en el índice especificado.

Comentarios

El archivo DLL de extensión no debe modificar esta estructura. Los cambios en la matriz de atributos se deben realizar llamando a las funciones proporcionadas como miembros de esta estructura.

Esta estructura la usan los archivos DLL de extensión que exportan RadiusExtensionProcess2. Funciones que agregan atributos a la matriz:

AgregueInsertAt para copiar el contenido de la estructura RADIUS_ATTRIBUTE proporcionada por el autor de la llamada. Por lo tanto, los archivos DLL de extensión que exportan RadiusExtensionProcess2 no necesitan exportar RadiusExtensionFreeAttributes.

Las funciones GetRequest y GetResponse devuelven esta estructura.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008
Encabezado authif.h

Consulte también

Acerca de las extensiones NPS

Referencia de extensiones NPS

Estructuras de extensiones NPS

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2