SetAt 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 SetAt function replaces the attribute at the specified index with the specified attribute.

Syntax


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

Parameters

This [in]

Pointer to the RADIUS_ATTRIBUTE_ARRAY structure that represents the array of attributes that contains the attribute to replace.

The GetRequest and GetResponse functions return pointers to RADIUS_ATTRIBUTE_ARRAY structures.

dwIndex [in]

Specifies the index of the attribute to replace.

Use the GetSize function to determine the size of the array. The largest index is one less than the size of the array.

pAttr [in]

Pointer to a RADIUS_ATTRIBUTE structure. The attribute represented by this structure replaces the attribute at the specified index.

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:

ERROR_INVALID_PARAMETER

The index is out of range, or either this parameter or pAttr is NULL.

ERROR_ACCESS_DENIED

The attribute to be set is read-only.

Remarks

This function is provided by NPS. NPS returns a pointer to this function as a member of the RADIUS_ATTRIBUTE_ARRAY structure.

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: