# 编辑会议
#### EditConf
**接口描述**
该接口用于编辑已预约的会议。
**注意事项**
1. 该接口在已登录状态下才能调用。
2. 调用该接口时，仅能编辑尚未开始的会议，若会议已召开，接口将返回失败。
3. 该接口为异步接口，返回值只代表接口是否调用成功，实际业务处理结果在对应的回调函数中返回。
4. **所有字段必填，编辑会议前需要查询会议详情，不需要变更的数据请使用查询会议详情** **返回的数据赋值**。
**方法定义**
```
HWM_SDK_AGENT_API hwmsdk::HwmErrCode EditConf(const HwmEditConfParam *confParam);
```
**回调函数**
```
virtual void OnEditConfResult(hwmsdk::HwmErrCode ret, const char* reason) {};
```
**参数描述**
 表1结构体HwmEditConfParam参数说明 
| 参数                       | 是否必须 | 类型                                                                                                                                                     | 描述                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| confId                   | 是    | char\[\]                                                                                                                                               | 会议ID。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| subject                  | 是    | char\[\]                                                                                                                                               | 会议主题。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| startTimeStamp           | 是    | long long                                                                                                                                              | 会议开始时间，UTC时间戳，精度秒。                                                                                                                                                                                                                                                                                                                                                                                                    |
| duration                 | 是    | int                                                                                                                                                    | 会议时长，minute。                                                                                                                                                                                                                                                                                                                                                                                                          |
| confType                 | 是    | [HwmConfMediaType](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0013.html#ZH-CN_TOPIC_0272621229__table115310444535)           | 会议类型。默认语音会议。                                                                                                                                                                                                                                                                                                                                                                                                          |
| isNeedConfPwd            | 是    | bool                                                                                                                                                   | 是否需要密码。默认不需要密码。                                                                                                                                                                                                                                                                                                                                                                                                       |
| isRecordOn               | 是    | bool                                                                                                                                                   | 录制会议开关。(字段即将废弃，不建议使用)                                                                                                                                                                                                                                                                                                                                                                                                 |
| isLiveOn                 | 是    | bool                                                                                                                                                   | 保留。编辑会议时透传会议详情此字段。                                                                                                                                                                                                                                                                                                                                                                                                    |
| isAutoRecordOn           | 是    | bool                                                                                                                                                   | 会议自动录制开关。                                                                                                                                                                                                                                                                                                                                                                                                             |
| timeZone                 | 是    | int                                                                                                                                                    | 时区码，请参考[时区表](https://support.huaweicloud.com/api-meeting/meeting_21_0110.html)。                                                                                                                                                                                                                                                                                                                                       |
| vmrFlag                  | 是    | bool                                                                                                                                                   | 是否是vmr会议。不可修改，填入会议详情返回值（废弃）                                                                                                                                                                                                                                                                                                                                                                                           |
| vmrId                    | 是    | char\[\]                                                                                                                                               | 云会议室唯一ID。不可修改，填入会议详情返回值                                                                                                                                                                                                                                                                                                                                                                                               |
| joinConfRestrictionType  | 是    | [HwmJoinConfPermissionType](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0013.html#ZH-CN_TOPIC_0272621229__table2028714197616) | 允许入会范围限制。默认所有用户。                                                                                                                                                                                                                                                                                                                                                                                                      |
| isSmsOn                  | 是    | bool                                                                                                                                                   | 保留字段，暂不提供短信通知能力。                                                                                                                                                                                                                                                                                                                                                                                                      |
| isMailOn                 | 是    | bool                                                                                                                                                   | 发送邮件通知开关。                                                                                                                                                                                                                                                                                                                                                                                                             |
| isEmailCalendarOn        | 是    | bool                                                                                                                                                   | 发送邮件日历开关。                                                                                                                                                                                                                                                                                                                                                                                                             |
| attendees                | 是    | [HwmAttendeeInfo](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0013.html#ZH-CN_TOPIC_0272621229__table825115232216)\*          | 与会者列表。                                                                                                                                                                                                                                                                                                                                                                                                                |
| attendeeLen              | 是    | unsigned int                                                                                                                                           | 与会者列表长度。                                                                                                                                                                                                                                                                                                                                                                                                              |
| vmrConfIdType            | 是    | [HwmVmrConfIdType](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0013.html#ZH-CN_TOPIC_0272621229__table122538152294)           | 云会议室的会议ID类型。不可修改，会议详情中vmrConferenceId非空，填入HWM_VMR_CONF_ID_TYPE_FIXED；会议详情中vmrConferenceId为空，填入HWM_VMR_CONF_ID_TYPE_RANDOM                                                                                                                                                                                                                                                                                             |
| isOpenWaitingRoom        | 是    | bool                                                                                                                                                   | 等候室开启开关 说明： 需要等候室功能开通后才能生效                                                                                                                                                                                                                                                                                                           |
| allowGuestStartConf      | 是    | bool                                                                                                                                                   | 是否允许来宾提前启动会议。 说明： - 仅针对随机会议ID的会议生效。  - 固定会议ID的会议，请使用[修改云会议室信息](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0017.html)接口设置。   |
| allowGuestStartConfTime  | 是    | unsigned int                                                                                                                                           | 允许来宾提前入会时间范围(单位：分钟) ：0-随时，n-提前n分钟启动会议。                                                                                                                                                                                                                                                                                                                                                                                |
| concurrentParticipants   | 是    | unsigned int                                                                                                                                           | 会议方数，会议最大与会人数限制。 注：不填则不限制                                                                                                                                                                                                                                                                                                                                                    |
| customInfo               | 是    | char\[\]                                                                                                                                               | 自定义扩展信息                                                                                                                                                                                                                                                                                                                                                                                                               |
| defaultSummaryState      | 是    | [HwmSummaryState](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0002.html#ZH-CN_TOPIC_0269368387__table1391194915188)           | 会议云录制是否包含纪要，初始值。                                                                                                                                                                                                                                                                                                                                                                                                      |
| autoMuteMode             | 是    | [HwmAutoMuteType](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0002.html#ZH-CN_TOPIC_0269368387__table1710488141910)           | 来宾入会，软终端是否自动静音。                                                                                                                                                                                                                                                                                                                                                                                                       |
| hardTerminalAutoMuteMode | 是    | [HwmAutoMuteType](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0002.html#ZH-CN_TOPIC_0269368387__table1710488141910)           | 来宾入会，硬终端是否自动静音。                                                                                                                                                                                                                                                                                                                                                                                                       |
| autoPublishSummary       | 是    | bool                                                                                                                                                   | 是否自动发布纪要（免人工审核）。                                                                                                                                                                                                                                                                                                                                                                                                      |
   
**返回值**
表2返回值 
| 类型         | 描述                                                                                                           |
|:---|:---|
| HwmErrCode | 成功返回0，其他值表示失败。失败返回值见[错误码参考](https://support.huaweicloud.com/sdkreference-meeting/meeting_control_0022.html)。 |
   
**示例代码**
```
/**
* 编辑会议接口
*/
int demoEditConfDlg::EditConf()
{
    hwmsdkagent::HwmConfDetail confDetail{0}; //从缓存中得到会议详情数据赋予confDetail
    hwmsdkagent::HwmEditConfParam editConfParam{ 0 };
    //根据实际需求拷贝confDetail的数据
    strncpy_s(editConfParam.confId, confDetail.confListInfo.confId, HWM_MAX_CONF_ID_LEN);
    editConfParam.vmrFlag = confDetail.vmrFlag;
    strncpy_s(editConfParam.vmrId, confInfo.vmrId, HWM_MAX_VMR_CONF_ID_LEN);
    // 此处省略部分赋值代码
    editConfParam.timeZone = 56; // 本地时区，用户依据自身情况自己调整，56东八区
    editConfParam.isRecordOn = false;
    editConfParam.isAutoRecordOn = false;
    editConfParam.startTimeStamp = 1598398920; //utc时间戳
    editConfParam.duration = 0 * 60 + 30;//会议时长
    editConfParam.joinConfRestrictionType = hwmsdkagent::HwmJoinConfPermissionType::RESTRICTION_CALL_IN_ALL; //取编辑会议上面的允许入会用户类型
    // vmrConferenceId非空是固定ID,为空则是随机id
    editConfParam.vmrConfIdType = (strlen(confInfo.confListInfo.vmrConferenceId) != 0) ?
        hwmsdkagent::HwmVmrConfIdType::HWM_VMR_CONF_ID_TYPE_FIXED : hwmsdkagent::HwmVmrConfIdType::HWM_VMR_CONF_ID_TYPE_RANDOM;
    return hwmsdkagent::EditConf(&editConfParam);
}
```