# cnfGetConferenceList

Returns the list of conferences running on a resource.

#### Prototype

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 values

Return value | Description
SUCCESS |
CTAERR_BAD_ARGUMENT | numconfid pointer is NULL.
CTAERR_INVALID_HANDLE | cnfresourcehd is not a valid conference resource handle.

#### Details

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.

#### See also

cnfCreateConference, cnfGetConferenceInfo, cnfGetResourceInfo, cnfGetResourceList

#### Example

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);
}