Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Add callback function

Note  Internet Authentication Service (IAS) was renamed Network Policy Server (NPS) starting with Windows Server 2008. The content of this topic applies to both IAS and NPS. Throughout the text, NPS is used to refer to all versions of the service, including the versions originally referred to as IAS.
 

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

Syntax


DWORD WINAPI Add(
  _In_ _RADIUS_ATTRIBUTE_ARRAY *This,
  _In_ RADIUS_ATTRIBUTE        *pAttr
);

Parameters

This [in]

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 [in]

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:

E_ACCESSDENIED

The NPS Extension DLL attempted to add an attribute that Extension 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 NPS. NPS returns a pointer to this function as a member of the RADIUS_ATTRIBUTE_ARRAY structure.

NPS 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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

AuthIf.h

See also

About NPS Extensions
NPS Extensions Reference
NPS Extensions Functions
RADIUS_ATTRIBUTE_ARRAY

 

 

Show: