Add Callback Function

The Add function appends a new attribute to the end of the array.

DWORD WINAPI Add(
  [in]                 _RADIUS_ATTRIBUTE_ARRAY* This,
  [in]                 RADIUS_ATTRIBUTE* pAttr
);

Parameters

• This
  Pointer to the RADIUS_ATTRIBUTE_ARRAY structure that represents the array of attributes to which to append the specified attribute.

  The GetRequest and GetResponse functions return pointers to RADIUS_ATTRIBUTE_ARRAY structures.

• pAttr
  Pointer to a RADIUS_ATTRIBUTE structure for the attribute to append to the array.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes:

Value	Meaning
E_ACCESSDENIED	The plug-in DLL attempted to add an attribute that plug-in DLLs are not allowed to add, or the DLL attempted to add an additional instance of an attribute of which only a single instance is allowed.
ERROR_INVALID_PARAMETER	The index is out of range.

Remarks

This function is provided by Internet Authentication Service (IAS). IAS returns a pointer to this function as a member of the RADIUS_ATTRIBUTE_ARRAY structure.

IAS copies the contents of the RADIUS_ATTRIBUTE structure pointed to by the pAttr parameter. Therefore, Extension DLLs that export RadiusExtensionProcess2 need not export RadiusExtensionFreeAttributes.

Requirements

Server	Requires Windows Server 2008 or Windows Server 2003.
Header	Declared in AuthIf.h.

See Also

About Internet Authentication Service
Internet Authentication Service Reference
Internet Authentication Service Functions
RADIUS_ATTRIBUTE_ARRAY

Send comments about this topic to Microsoft

Build date: 10/1/2007