Previous Topic: SmDirGetUserAttr()Next Topic: SmDirGetUserClasses()

Programming Guides › Programming Guide for C › Directory API Guidance › Directory API Reference › SmDirGetUserAttrMulti()

SmDirGetUserAttrMulti()

The SiteMinder Policy Server calls SmDirGetUserAttrMulti() so that you can retrieve an array of values for a single attribute. The provider needs to handle the case where this function is called and the attribute has only a single value.

SiteMinder calls SmDirFreeStringArray() to free the lpszAttrData buffer.

Syntax

int SM_EXTERN SmDirGetUserAttrMulti (
   const Sm_Api_Context_t*  lpApiContext,
   void*                    pHandle,
   void*                    pInstanceHandle,
   const char*              lpszUserDN,
   const char*              lpszAttrName,
   char***                  lpszAttrData
);

Parameter

I/O

Description

lpApiContext

I

Pointer to the API context structure.

pHandle

I

The address of the pointer returned by SmDirInit().

pInstanceHandle

I

The address of a pointer to the user instance handle.

lpszUserDN

I

Buffer containing the user DN whose user attributes has to be retrieved.

lpszAttrName

I

Buffer containing the name of the user attribute.

lpszAttrData

O

Buffer containing the value of the user attribute. Look up the value of the attribute named in lpszAttrName and return the value in lpszAttrData.

Returns

Returns 0 if successful or -1 if not successful.