RADIUS_ATTRIBUTE_ARRAY 結構 (authif.h)
語法
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 函式來判斷數位的大小。 最大的索引是小於陣列的大小。
GetSize
NPS 提供的 GetSize 函式指標。 NPS 會設定成員的值。
GetSize 函式會傳回屬性數位的大小。
GetSize 函式會傳回屬性陣列的大小，而不是最大的索引。 因為屬性陣列使用以零起始的索引，所以陣列的大小大於最大索引。
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 函式來判斷數位的大小。 最大的索引是小於陣列的大小。
pAttr
要插入數位之屬性 的RADIUS_ATTRIBUTE 結構指標。
RemoveAt
NPS 所提供 RemoveAt 函式的指標。 NPS 會設定成員的值。
RemoveAt 函式會移除數位中指定索引處的屬性。
當 RemoveAt 函式從數位中移除屬性時，它會在較高索引處遞減任何既有屬性的索引。
This
RADIUS_ATTRIBUTE_ARRAY 結構的指標，表示要從中移除指定屬性的屬性陣列。
GetRequest 和 GetResponse 函式會傳回RADIUS_ATTRIBUTE_ARRAY結構的指標。
dwIndex
指定要移除的屬性索引。
使用 GetSize 函式來判斷數位的大小。 最大的索引是小於陣列的大小。
SetAt
NPS 提供的 SetAt 函式指標。 NPS 會設定成員的值。
SetAt 函式會將位於指定索引處的屬性取代為指定的屬性。
This
RADIUS_ATTRIBUTE_ARRAY 結構的指標，表示包含要取代之屬性的屬性陣列。
GetRequest 和 GetResponse 函式會傳回RADIUS_ATTRIBUTE_ARRAY結構的指標。
dwIndex
指定要取代的屬性索引。
使用 GetSize 函式來判斷數位的大小。 最大的索引是小於陣列的大小。
pAttr
RADIUS_ATTRIBUTE 結構的指標。 這個結構所表示的屬性會取代位於指定索引處的屬性。
備註
延伸模組 DLL 不得修改這個結構。 呼叫提供做為這個結構成員的函式，即可變更屬性陣列。
此結構是由導出 RadiusExtensionProcess2的擴充功能 DLL 使用。 將屬性新增至陣列的函式：
新增InsertAt 會複製呼叫端提供 之RADIUS_ATTRIBUTE 結構的內容。 因此，導出 RadiusExtensionProcess2 的擴充 DLL 不需要匯出 RadiusExtensionFreeAttributes。
此結構是由 函式 GetRequest 和 GetResponse 傳回。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | authif.h |