cnfLeaveConference

Removes a member from a conference and destroys the member identifier.

Prototype

DWORD cnfLeaveConference ( CNFRESOURCEHD cnfresourcehd, DWORD memberid)

Argument

Description

cnfresourcehd

Handle returned by cnfOpenResource.

memberid

Member identifier returned by cnfJoinConference or cnfGetMemberList.


Return values

Return value

Description

SUCCESS

 

CTAERR_INVALID_HANDLE

cnfresourcehd is not a valid conference resource handle.

CNFERR_BOARD_TIMEOUT

Board timed out while waiting for a response message.

CNFERR_INVALID_IDENTIFIER

memberid is not a valid member identifier.


Details

cnfLeaveConference removes the member specified by memberid from cnfresourcehd. If the remaining number of members in the conference is less than the allocated number, the seat resource freed by this member is available for that conference only. Otherwise, the corresponding resource is available for any conference on the resource. For more information on removing members, refer to Closing a conference.

See also

cnfJoinConference

Example

extern CNFRESOURCEHD cnfresourcehd;

DWORD leaveConference(DWORD memberid)
{
 DWORD error;
 unsigned numtalkerids = 0;

 error = cnfLeaveConference(cnfresourcehd, memberid);
 if (error != SUCCESS)
{
printf("Error when leaving the conference :%d", error);
}

return (error);
}