Returns the list of members currently attending a given conference.
DWORD cnfGetMemberList ( CNFRESOURCEHD cnfresourcehd, DWORD confid, unsigned maxmemberids, DWORD *memberidlist, unsigned *nummemberids)
|
Argument |
Description |
|
cnfresourcehd |
Handle returned by cnfOpenResource. |
|
confid |
Conference identifier returned by cnfCreateConference. |
|
maxmemberids |
Maximum number of entries in memberidlist array. |
|
memberidlist |
Pointer to an array of DWORD to receive the list of member identifiers. If NULL, this function returns the number of members attending the conference in nummemberids. |
|
nummemberids |
Pointer to the returned number of member identifiers. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
nummemberids pointer is NULL. |
|
CTAERR_INVALID_HANDLE |
cnfresourcehd is not a valid conference resource handle. |
|
CNFERR_INVALID_IDENTIFIER |
confid is not a valid conference identifier. |
cnfGetMemberList returns the actual list of members attending a given conference. To determine the current number of members without identifiers, set maxmemberids to 0 and memberidlist to NULL.
For more information, refer to Creating conferences.
cnfGetMemberInfo, cnfJoinConference
extern CNFRESOURCEHD cnfresourcehd;
unsigned getMemberList(DWORD confid, DWORD *memberidlist,
unsigned maxmemberids)
{
DWORD error;
unsigned nummemberids = 0;
error = cnfGetMemberList(cnfresourcehd, confid, maxmemberids,
memberidlist, &nummemberids);
if (error != SUCCESS)
{
printf("Error when retrieving member list :%d", error);
}
return (nummemberids);
}