Condividi tramite


RADIUS_ATTRIBUTE_ARRAY struttura (authif.h)

Nota Internet Authentication Service (IAS) è stato rinominato Server criteri di rete (NPS) a partire da Windows Server 2008. Il contenuto di questo argomento si applica sia a IAS che a NPS. In tutto il testo, i criteri di rete vengono usati per fare riferimento a tutte le versioni del servizio, incluse le versioni originariamente denominate IAS.
 
La struttura RADIUS_ATTRIBUTE_ARRAY rappresenta una matrice di attributi.

Sintassi

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;

Members

cbSize

Specifica le dimensioni della struttura.

Add

Puntatore alla funzione Add fornita da NPS. NpS imposta il valore del membro.

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi a cui aggiungere l'attributo specificato.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

pAttr

Puntatore a una struttura RADIUS_ATTRIBUTE per l'attributo da aggiungere alla matrice.

AttributeAt

Puntatore alla funzione AttributeAt fornita da NPS. NpS imposta il valore del membro.

La funzione AttributeAt restituisce un puntatore const all'attributo specificato all'interno della matrice.

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi da cui recuperare l'attributo specificato.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

dwIndex

Specifica l'indice dell'attributo da recuperare. La funzione restituisce NULL se questo indice non è compreso nell'intervallo.

Usare la funzione GetSize per determinare le dimensioni della matrice. L'indice più grande è minore delle dimensioni della matrice.

GetSize

Puntatore alla funzione GetSize fornita da NpS. NpS imposta il valore del membro.

La funzione GetSize restituisce le dimensioni della matrice di attributi.

La funzione GetSize restituisce le dimensioni della matrice di attributi, non l'indice più grande. Poiché le matrici di attributi usano indici in base zero, la dimensione della matrice è maggiore dell'indice più grande.

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi per cui recuperare le dimensioni.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

InsertAt

Puntatore alla funzione InsertAt fornita da NPS. NpS imposta il valore del membro.

La funzione InsertAt inserisce l'attributo specificato nell'indice specificato nella matrice.

Quando la funzione InsertAt inserisce un nuovo attributo nella matrice, incrementa l'indice dell'attributo preesistente in questo indice. Analogamente, incrementa l'indice di eventuali attributi preesistenti in indici superiori.

Per aggiungere un attributo alla fine della matrice di attributi, usare la funzione Aggiungi .

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi in cui inserire l'attributo specificato.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

dwIndex

Specifica l'indice in corrispondenza del quale inserire l'attributo specificato.

Usare la funzione GetSize per determinare le dimensioni della matrice. L'indice più grande è minore delle dimensioni della matrice.

pAttr

Puntatore a una struttura RADIUS_ATTRIBUTE per l'attributo da inserire nella matrice.

RemoveAt

Puntatore alla funzione RemoveAt fornita da NPS. NpS imposta il valore del membro.

La funzione RemoveAt rimuove l'attributo in corrispondenza dell'indice specificato nella matrice.

Quando la funzione RemoveAt rimuove un attributo dalla matrice, decreta l'indice di eventuali attributi preesistenti in indici superiori.

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi da cui rimuovere l'attributo specificato.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

dwIndex

Specifica l'indice dell'attributo da rimuovere.

Usare la funzione GetSize per determinare le dimensioni della matrice. L'indice più grande è minore delle dimensioni della matrice.

SetAt

Puntatore alla funzione SetAt fornita da NpS. NpS imposta il valore del membro.

La funzione SetAt sostituisce l'attributo in corrispondenza dell'indice specificato con l'attributo specificato.

This

Puntatore alla struttura RADIUS_ATTRIBUTE_ARRAY che rappresenta la matrice di attributi che contiene l'attributo da sostituire.

Le funzioni GetRequest e GetResponse restituiscono puntatori alle strutture RADIUS_ATTRIBUTE_ARRAY.

dwIndex

Specifica l'indice dell'attributo da sostituire.

Usare la funzione GetSize per determinare le dimensioni della matrice. L'indice più grande è minore delle dimensioni della matrice.

pAttr

Puntatore a una struttura RADIUS_ATTRIBUTE . L'attributo rappresentato da questa struttura sostituisce l'attributo in corrispondenza dell'indice specificato.

Commenti

La DLL dell'estensione non deve modificare questa struttura. Le modifiche alla matrice di attributi devono essere apportate chiamando le funzioni fornite come membri di questa struttura.

Questa struttura viene usata dalle DLL di estensione che esportare RadiusExtensionProcess2. Funzioni che aggiungono attributi alla matrice:

AggiungereInsertAt copiare il contenuto della struttura di RADIUS_ATTRIBUTE fornita dal chiamante. Di conseguenza, le DLL di estensione che esportare RadiusExtensionProcess2 non devono esportare RadiusExtensionFreeAttributes.

Questa struttura viene restituita dalle funzioni GetRequest e GetResponse.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008
Intestazione authif.h

Vedi anche

Informazioni sulle estensioni dei criteri di rete

Informazioni di riferimento sulle estensioni del server di rete

Strutture di estensioni del server di rete

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2