メモ Windows Server 2008 以降、インターネット認証サービス (IAS) の名前がネットワーク ポリシー サーバー (NPS) に変更されました。 このトピックの内容は、IAS と NPS の両方に適用されます。 テキスト全体を通じて、NPS は、最初に IAS と呼ばれたバージョンを含め、サービスのすべてのバージョンを参照するために使用されます。
構文
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 によって使用されます。 配列に属性を追加する関数:
AddInsertAt copy the contents of the caller-supplied RADIUS_ATTRIBUTE structure. したがって、 RadiusExtensionProcess2 をエクスポートする拡張 DLL では、 RadiusExtensionFreeAttributes をエクスポートする必要はありません。
この構造体は、 GetRequest 関数と GetResponse 関数によって返されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | authif.h |