RADIUS_ATTRIBUTE_ARRAY-Struktur (authif.h)

Hinweis Der Internetauthentifizierungsdienst (Internet Authentication Service, IAS) wurde ab Windows Server 2008 in Netzwerkrichtlinienserver (Network Policy Server, NPS) umbenannt. Der Inhalt dieses Themas gilt sowohl für IAS als auch für NPS. Im gesamten Text wird NPS verwendet, um auf alle Versionen des Diensts zu verweisen, einschließlich der Versionen, die ursprünglich als IAS bezeichnet wurden.

 

Die RADIUS_ATTRIBUTE_ARRAY-Struktur stellt ein Array von Attributen dar.

Syntax

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;

Member

cbSize

Gibt die Größe der -Struktur an.

Add

Zeiger auf die vom NPS bereitgestellte Funktion Hinzufügen . NPS legt den Wert des Members fest.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY Struktur, die das Array von Attributen darstellt, an das das angegebene Attribut angefügt werden soll.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

pAttr

Zeiger auf eine RADIUS_ATTRIBUTE-Struktur für das Attribut, das an das Array angefügt werden soll.

AttributeAt

Zeiger auf die vom NPS bereitgestellte AttributeAt-Funktion . NPS legt den Wert des Members fest.

Die AttributeAt-Funktion gibt einen const-Zeiger auf das angegebene Attribut innerhalb des Arrays zurück.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY-Struktur , die das Array von Attributen darstellt, aus dem das angegebene Attribut abgerufen werden soll.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

dwIndex

Gibt den Index des abzurufenden Attributs an. Die Funktion gibt NULL zurück, wenn sich dieser Index außerhalb des Bereichs befindet.

Verwenden Sie die GetSize-Funktion , um die Größe des Arrays zu bestimmen. Der größte Index ist einer kleiner als die Größe des Arrays.

GetSize

Zeiger auf die getSize-Funktion , die von NPS bereitgestellt wird. NPS legt den Wert des Members fest.

Die GetSize-Funktion gibt die Größe des Attributarrays zurück.

Die GetSize-Funktion gibt die Größe des Attributarrays zurück, nicht den größten Index. Da Attributarrays nullbasierte Indizes verwenden, ist die Größe des Arrays um einen größer als der größte Index.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY Struktur, die das Array von Attributen darstellt, für das die Größe abgerufen werden soll.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

InsertAt

Zeiger auf die von NPS bereitgestellte InsertAt-Funktion . NPS legt den Wert des Members fest.

Die InsertAt-Funktion fügt das angegebene Attribut am angegebenen Index im Array ein.

Wenn die InsertAt-Funktion ein neues Attribut in das Array einfügt, wird der Index des bereits vorhandenen Attributs an diesem Index erhöht. Auf ähnliche Weise wird der Index aller bereits vorhandenen Attribute bei höheren Indizes erhöht.

Um ein Attribut am Ende des Attributarrays anzufügen, verwenden Sie die Funktion Hinzufügen.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY-Struktur , die das Array von Attributen darstellt, in das das angegebene Attribut eingefügt werden soll.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

dwIndex

Gibt den Index an, an dem das angegebene Attribut eingefügt werden soll.

Verwenden Sie die GetSize-Funktion , um die Größe des Arrays zu bestimmen. Der größte Index ist einer kleiner als die Größe des Arrays.

pAttr

Zeiger auf eine RADIUS_ATTRIBUTE Struktur für das Attribut, das in das Array eingefügt werden soll.

RemoveAt

Zeiger auf die removeAt-Funktion , die von NPS bereitgestellt wird. NPS legt den Wert des Members fest.

Die RemoveAt-Funktion entfernt das Attribut am angegebenen Index im Array.

Wenn die RemoveAt-Funktion ein Attribut aus dem Array entfernt, verringert sie den Index aller bereits vorhandenen Attribute bei höheren Indizes.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY-Struktur , die das Array von Attributen darstellt, aus dem das angegebene Attribut entfernt werden soll.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

dwIndex

Gibt den Index des zu entfernenden Attributs an.

Verwenden Sie die GetSize-Funktion , um die Größe des Arrays zu bestimmen. Der größte Index ist einer kleiner als die Größe des Arrays.

SetAt

Zeiger auf die setAt-Funktion , die von NPS bereitgestellt wird. NPS legt den Wert des Members fest.

Die SetAt-Funktion ersetzt das Attribut am angegebenen Index durch das angegebene Attribut.

Diese

Zeiger auf die RADIUS_ATTRIBUTE_ARRAY Struktur, die das Array von Attributen darstellt, das das zu ersetzende Attribut enthält.

Die Funktionen GetRequest und GetResponse geben Zeiger auf RADIUS_ATTRIBUTE_ARRAY Strukturen zurück.

dwIndex

Gibt den Index des zu ersetzenden Attributs an.

Verwenden Sie die GetSize-Funktion , um die Größe des Arrays zu bestimmen. Der größte Index ist einer kleiner als die Größe des Arrays.

pAttr

Zeiger auf eine RADIUS_ATTRIBUTE-Struktur . Das durch diese Struktur dargestellte Attribut ersetzt das Attribut am angegebenen Index.

Hinweise

Die Erweiterungs-DLL darf diese Struktur nicht ändern. Änderungen am Array von Attributen sollten durch Aufrufen der Funktionen vorgenommen werden, die als Member dieser Struktur bereitgestellt werden.

Diese Struktur wird von Erweiterungs-DLLs verwendet, die RadiusExtensionProcess2 exportieren. Die Funktionen, die dem Array Attribute hinzufügen:

Fügen SieInsertAt hinzu, kopieren Sie den Inhalt der vom Aufrufer bereitgestellten RADIUS_ATTRIBUTE-Struktur . Daher müssen Erweiterungs-DLLs, die RadiusExtensionProcess2 exportieren, radiusExtensionFreeAttributes nicht exportieren.

Diese Struktur wird von den Funktionen GetRequest und GetResponse zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	authif.h

Weitere Informationen

Informationen zu NPS-Erweiterungen

Referenz zu NPS-Erweiterungen

NPS-Erweiterungsstrukturen

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2