RADIUS_ATTRIBUTE_ARRAY 構造体 (authif.h)

[アーティクル]
08/22/2023

メモ Windows Server 2008 以降、インターネット認証サービス (IAS) の名前がネットワークポリシーサーバー (NPS) に変更されました。このトピックの内容は、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

NPS によって提供される Add 関数へのポインター。 NPS は、メンバーの値を設定します。

This

指定した属性を追加する属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

pAttr

配列に追加する属性の RADIUS_ATTRIBUTE 構造体へのポインター。

AttributeAt

NPS によって提供される AttributeAt 関数へのポインター。 NPS は、メンバーの値を設定します。

AttributeAt 関数は、配列内の指定した属性への const ポインターを返します。

This

指定した属性を取得する属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

dwIndex

取得する属性のインデックスを指定します。このインデックスが範囲外の場合、この関数は NULL を 返します。

配列のサイズを決定するには、 GetSize 関数を使用します。最大インデックスは、配列のサイズより 1 小さい値です。

GetSize

NPS によって提供される GetSize 関数へのポインター。 NPS は、メンバーの値を設定します。

GetSize 関数は、属性配列のサイズを返します。

GetSize 関数は、最大のインデックスではなく、属性配列のサイズを返します。属性配列は 0 から始まるインデックスを使用するため、配列のサイズは最大インデックスより 1 大きくなります。

This

サイズを取得する属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

InsertAt

NPS によって提供される InsertAt 関数へのポインター。 NPS は、メンバーの値を設定します。

InsertAt 関数は、指定した属性を配列内の指定したインデックスに挿入します。

InsertAt 関数は、配列に新しい属性を挿入すると、このインデックスにある既存の属性のインデックスをインクリメントします。同様に、既存の属性のインデックスを上位のインデックスでインクリメントします。

属性配列の末尾に属性を追加するには、 Add 関数を使用します。

This

指定した属性を挿入する属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

dwIndex

指定した属性を挿入する位置のインデックスを指定します。

配列のサイズを決定するには、 GetSize 関数を使用します。最大インデックスは、配列のサイズより 1 小さい値です。

pAttr

配列に挿入する属性の RADIUS_ATTRIBUTE 構造体へのポインター。

RemoveAt

NPS によって提供される RemoveAt 関数へのポインター。 NPS は、メンバーの値を設定します。

RemoveAt 関数は、配列内の指定したインデックス位置にある属性を削除します。

RemoveAt 関数は、配列から属性を削除すると、上位のインデックスで既存の属性のインデックスをデクリメントします。

This

指定した属性を削除する属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

dwIndex

削除する属性のインデックスを指定します。

配列のサイズを決定するには、 GetSize 関数を使用します。最大インデックスは、配列のサイズより 1 小さい値です。

SetAt

NPS によって提供される SetAt 関数へのポインター。 NPS は、メンバーの値を設定します。

SetAt 関数は、指定したインデックスにある属性を、指定した属性に置き換えます。

This

置き換える属性を含む属性の配列を表す RADIUS_ATTRIBUTE_ARRAY 構造体へのポインター。

GetRequest 関数と GetResponse 関数は、RADIUS_ATTRIBUTE_ARRAY構造体へのポインターを返します。

dwIndex

置換する属性のインデックスを指定します。

配列のサイズを決定するには、 GetSize 関数を使用します。最大インデックスは、配列のサイズより 1 小さい値です。

pAttr

RADIUS_ATTRIBUTE構造体へのポインター。この構造体で表される属性は、指定したインデックス位置にある属性を置き換えます。

注釈

拡張 DLL では、この構造体を変更することはできません。属性の配列に対する変更は、この構造体のメンバーとして提供される関数を呼び出すことによって行う必要があります。

この構造体は、 RadiusExtensionProcess2 をエクスポートする拡張 DLL によって使用されます。配列に属性を追加する関数:

Add InsertAt copy the contents of the caller-supplied RADIUS_ATTRIBUTE structure. したがって、 RadiusExtensionProcess2 をエクスポートする拡張 DLL では、 RadiusExtensionFreeAttributes をエクスポートする必要はありません。

この構造体は、 GetRequest 関数と GetResponse 関数によって返されます。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008
Header	authif.h