다음을 통해 공유


RADIUS_ATTRIBUTE_ARRAY 구조체(authif.h)

참고 IAS(인터넷 인증 서비스)의 이름이 Windows Server 2008부터 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는 멤버의 값을 설정합니다.

이번

지정된 특성을 추가할 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

pAttr

배열에 추가할 특성의 RADIUS_ATTRIBUTE 구조체에 대한 포인터입니다.

AttributeAt

NPS에서 제공하는 AttributeAt 함수에 대한 포인터입니다. NPS는 멤버의 값을 설정합니다.

AttributeAt 함수는 배열 내의 지정된 특성에 대한 const 포인터를 반환합니다.

이번

지정된 특성을 검색할 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

dwIndex

검색할 특성의 인덱스를 지정합니다. 이 인덱스가 범위를 벗어나면 함수는 NULL 을 반환합니다.

GetSize 함수를 사용하여 배열의 크기를 확인합니다. 가장 큰 인덱스는 배열 크기보다 작은 인덱스입니다.

GetSize

NPS에서 제공하는 GetSize 함수에 대한 포인터입니다. NPS는 멤버의 값을 설정합니다.

GetSize 함수는 특성 배열의 크기를 반환합니다.

GetSize 함수는 가장 큰 인덱스가 아닌 특성 배열의 크기를 반환합니다. 특성 배열은 0부터 시작하는 인덱스를 사용하므로 배열의 크기는 가장 큰 인덱스보다 큽니다.

이번

크기를 검색할 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

InsertAt

NPS에서 제공하는 InsertAt 함수에 대한 포인터입니다. NPS는 멤버의 값을 설정합니다.

InsertAt 함수는 배열의 지정된 인덱스에 지정된 특성을 삽입합니다.

InsertAt 함수가 배열에 새 특성을 삽입하면 이 인덱스에서 기존 특성의 인덱스가 증가합니다. 마찬가지로 더 높은 인덱스에서 기존 특성의 인덱스를 증가합니다.

특성 배열의 끝에 특성을 추가하려면 Add 함수를 사용합니다.

이번

지정된 특성을 삽입할 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

dwIndex

지정된 특성을 삽입할 인덱스를 지정합니다.

GetSize 함수를 사용하여 배열의 크기를 확인합니다. 가장 큰 인덱스는 배열 크기보다 작은 인덱스입니다.

pAttr

배열에 삽입할 특성의 RADIUS_ATTRIBUTE 구조체에 대한 포인터입니다.

RemoveAt

NPS에서 제공하는 RemoveAt 함수에 대한 포인터입니다. NPS는 멤버의 값을 설정합니다.

RemoveAt 함수는 배열의 지정된 인덱스에 있는 특성을 제거합니다.

RemoveAt 함수가 배열에서 특성을 제거하면 더 높은 인덱스에서 기존 특성의 인덱스가 감소합니다.

이번

지정된 특성을 제거할 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

dwIndex

제거할 특성의 인덱스를 지정합니다.

GetSize 함수를 사용하여 배열의 크기를 확인합니다. 가장 큰 인덱스는 배열 크기보다 작은 인덱스입니다.

SetAt

NPS에서 제공하는 SetAt 함수에 대한 포인터입니다. NPS는 멤버의 값을 설정합니다.

SetAt 함수는 지정된 인덱스의 특성을 지정된 특성으로 바꿉니다.

이번

바꿀 특성이 포함된 특성의 배열을 나타내는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터입니다.

GetRequestGetResponse 함수는 RADIUS_ATTRIBUTE_ARRAY 구조체에 대한 포인터를 반환합니다.

dwIndex

바꿀 특성의 인덱스를 지정합니다.

GetSize 함수를 사용하여 배열의 크기를 확인합니다. 가장 큰 인덱스는 배열 크기보다 작은 인덱스입니다.

pAttr

RADIUS_ATTRIBUTE 구조체에 대한 포인터입니다. 이 구조체가 나타내는 특성은 지정된 인덱스의 특성을 대체합니다.

설명

확장 DLL은 이 구조를 수정해서는 안됩니다. 특성 배열은 이 구조체의 멤버로 제공된 함수를 호출하여 변경해야 합니다.

이 구조체는 RadiusExtensionProcess2를 내보내는 확장 DLL에서 사용됩니다. 배열에 특성을 추가하는 함수:

InsertAt추가 호출자가 제공한 RADIUS_ATTRIBUTE 구조체의 내용을 복사합니다. 따라서 RadiusExtensionProcess2 를 내보내는 확장 DLL은 RadiusExtensionFreeAttributes를 내보낼 필요가 없습니다.

이 구조체는 GetRequestGetResponse 함수에 의해 반환됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2008
머리글 authif.h

추가 정보

NPS 확장 정보

NPS 확장 참조

NPS 확장 구조체

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2