Returns the list of conferences running on a resource.
DWORD cnfGetConferenceList ( CNFRESOURCEHD cnfresourcehd, unsigned maxconfids, DWORD *confidlist, unsigned *numconfids)
|
Argument |
Description |
|
cnfresourcehd |
Handle returned by cnfOpenResource. |
|
maxconfids |
Maximum number of entries in confidlist array. |
|
confidlist |
Pointer to an array of DWORD to receive the list of conference identifiers. If NULL, this function returns the number of conferences currently running in numconfids. |
|
numconfids |
Pointer to the returned number of conference identifiers. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
numconfid pointer is NULL. |
|
CTAERR_INVALID_HANDLE |
cnfresourcehd is not a valid conference resource handle. |
cnfGetConferenceList returns the actual list of conference identifiers running on a given resource. To determine the number of conferences currently running, set maxconfids to 0 and confidlist to NULL.
For more information, refer to Creating conferences.
cnfCreateConference, cnfGetConferenceInfo, cnfGetResourceInfo, cnfGetResourceList
extern CNFRESOURCEHD cnfresourcehd;
unsigned getConferenceList(DWORD *confidlist, unsigned maxconfids)
{
DWORD error;
unsigned numconfids = 0;
error=cnfGetConferenceList(cnfresourcehd, maxconfids,
confidlist, &numconfids);
if (error != SUCCESS)
{
printf("Error when retrieving conference list :%d", error);
}
return (numconfids);
}