Previous Topic: SmDirAddEntry()Next Topic: SmDirAddMemberToRole()

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

SmDirAddMemberToGroup()

The SiteMinder Policy Server calls SmDirAddMemberToGroup() so that you can add a user or group to an existing group.

If you want to add a user or group to a role, use SmDirAddMemberToRole(). The difference between a group and a role is defined by your custom directory provider. For some providers, there is no difference.

Syntax

int SM_EXTERN SmDirAddMemberToGroup (
   const Sm_Api_Context_t*  lpApiContext,
   void*                    pHandle,
   void*                    pInstanceHandle,
   const char*              lpszMemberDN,
   const char*              lpszGroupDN
);

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 directory instance handle.

lpszMemberDN

I

Buffer containing the distinguished name for the user or group being added to the existing group.

lpszGroupDN

I

Buffer containing the distinguished name for the group to which the member is being added.

Returns

Returns 0 if successful or -1 if not successful.

Remarks

This function is called when Delegated Management Services is used to assign either a user or a group to an existing group.