Sets the value of a conference attribute.
DWORD cnfSetConferenceAttribute ( CNFRESOURCEHD cnfresourcehd, DWORD confid, DWORD attribute, INT32 value)
|
Argument |
Description |
|
cnfresourcehd |
Handle returned by cnfOpenResource. |
|
confid |
Conference identifier returned by cnfCreateConference. |
|
attribute |
Specifies the attribute to set. Refer to cnfGetConferenceAttribute for a complete list and description of the conference attributes. |
|
value |
New value for the attribute. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
cnfresourcehd is not a valid conferencing resource handle. |
|
CNFERR_BOARD_TIMEOUT |
Board timed out while waiting for a response message. |
|
CNFERR_INVALID_ATTRIBUTE |
attribute is not a valid attribute for a conference. |
|
CNFERR_INVALID_IDENTIFIER |
confid is not a valid conference identifier. |
|
CNFERR_INVALID_PARAMETER |
value is inconsistent or out of range for the given attribute. |
Refer to cnfGetConferenceAttribute for a complete description of the conference attributes. Refer to Setting conference attributes for information on setting conference attributes.
Refer to CNF.CONFERENCE_ATTR for information about attribute default values.
cnfCreateConference, cnfGetConferenceInfo
// Setup 1 second between each active talker change event
error = cnfSetConferenceAttribute ( cnfresourcehd, confid,
CONF_ATTR_ACTIVE_TALKERS_TIMER,
1000);