Redefines the number of members allocated to a conference.
DWORD cnfResizeConference ( CNFRESOURCEHD cnfresourcehd, DWORD confid, DWORD mode, unsigned number)
|
Argument |
Description |
|
cnfresourcehd |
Handle returned by cnfOpenResource. |
|
confid |
Conference identifier returned by cnfCreateConference. |
|
mode |
Specifies the resizing mode to be used. Refer to the Details section for a description of the allowed values for this parameter. |
|
number |
Number associated with the given resizing mode. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
mode is not one of the possible values. |
|
CTAERR_BOARD_ERROR |
Conference cannot be resized because of an HMIC limitation or an on-board memory limitation (only with AG 2000 boards). |
|
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 |
confid is not a valid conference identifier. |
|
CNFERR_NOT_ENOUGH_RESOURCE_SPACE |
Conference cannot be resized because the resource is full. Either the number of reserved seats with the requested capabilities is exhausted, or the number of conference IDs for that resource is exhausted. There are only 255 conference IDs per conference resource. |
cnfResizeConference enables the application to change the number of members allocated on the resource for a conference. The resizing operation to perform is specified by mode. This argument must be one of the following values (predefined in cnfdef.h):
|
Mode |
Description |
|---|---|
|
CNF_REDUCE_ALLOCATED |
Reduces the number of allocated members by number. |
|
CNF_INCREASE_ALLOCATED |
Increases the number of allocated members by number. |
|
CNF_RESIZE_ALLOCATED |
Resizes the number of allocated members to number. |
Refer to Creating conferences for more information.
cnfCreateConference, cnfGetConferenceInfo
DWORD error;
/* Add space for a new allocated member */
error = cnfResizeConference (cnfresourcehd, confid,
CNF_INCREASE_ALLOCATED, 1);
if (error != SUCCESS)
{
printf("Error when resizing conference : %d", error);
return(error);
}