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 傳回。

規格需求

另請參閱

關於 NPS 擴充功能

NPS 延伸模組參考

NPS 延伸模組結構

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2