Adds a new member to a conference.

DWORD cnfJoinConference ( CNFRESOURCEHD cnfresourcehd,
DWORD confid,
CNF_MEMBER_PARMS *parms,
DWORD *memberid)

cnfresourcehd Handle returned by cnfOpenResource.

confid Conference identifier returned by cnfCreateConference.

parms Pointer to a CNF_MEMBER_PARMS structure:

typedef struct
{
DWORD   size;                      /* Size of the structure      */
DWORD user_value                  /* Application provided value */
} CNF_MEMBER_PARMS; 

If parms is NULL, take the default parameters.

memberid Pointer to a returned member identifier.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  memberid is a NULL pointer.
• CTAERR_BOARD_ERROR
  The new member cannot be added because of an HMIC limitation or on-board memory limitation (only with AG 2000 boards). This happens only when the member is added on-the-fly without being allocated.
• CTAERR_INVALID_HANDLE
  cnfresourcehd is not a valid conferencing resource handle.
• CNFERR_BOARD_TIMEOUT
  The board timed out while waiting for a response message.
• CNFERR_INVALID_IDENTIFIER
  confid is not a valid conference identifier.
• CNFERR_INVALID_PARAMETER
  parms is inconsistent or out of range.
• CNFERR_NOT_ENOUGH_RESOURCE_SPACE
  The member cannot be added because the conferencing resource is full.

This function adds a new member to a conference specified by confid. If the function succeeds, the new member identifier is returned in memberid.

The default values of member attributes are taken from the corresponding CT Access parameters. To allow the new member to talk, set the cnf.member.defattr.talker_enable parameter in the
CT Access parameter section of cnf.cfg, or set the attribute in the application by using cnfSetMemberAttribute or cnfSetMemberAttributeList.

For more information about adding a member, see Section 4.6.

cnfGetMemberInfo, cnfLeaveConference, cnfSetMemberAttribute

extern CNFRESOURCEHD cnfresourcehd;
 
DWORD myJoinConference(DWORD confid, DWORD *memberid)
{
   DWORD error;
   CNF_MEMBER_INFO memberinfo;

   error = cnfJoinConference (cnfresourcehd, confid, NULL,
                              &memberid); 
   if (error != SUCCESS)
      {
      printf("Error when joining conference : %d", error);
      return(error);
      }

   error = cnfGetMemberInfo (cnfresourcehd, *memberid,
        &memberinfo, sizeof(CNF_MEMBER_INFO)); 

/* Perform switching operation by using memberinfo.stream and timeslot */

   error = cnfSetMemberAttribute (cnfresourcehd, *memberid,
                                  MEMBER_ATTR_TALKER_ENABLE, TRUE);
   return(error);   
}