Setting the Participant Name

RenameSelf

API Description

This API is used to set the participant name.

Precautions

This API is an asynchronous API. The return value only indicates whether the API is successfully called. The actual service processing result is returned in the corresponding callback function.

Method Definition

    
         HWM_SDK_AGENT_API hwmsdk::HwmErrCode RenameSelf(const char name[HWM_MAX_DISPLAY_NAME_LEN]);

Callback Function

   
        virtual void OnRenameSelfResult(hwmsdk::HwmErrCode ret, const char* reason) {};

Parameter Description

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
name	Yes	char[]	Participant name.

Return Values

**Table 2** Return values
Type	Description
HwmErrCode	If 0 is returned, the operation is successful. If other values are returned, the operation fails. For details about values returned upon failures, see Common Error Codes.

Sample Code

   
        void demoRenameSelfDlg::OnBnClickedOk()
{
    // Set the participant name.
    int ret = hwmsdkagent::RenameSelf(GetNameString().c_str());
    if(ret != hwmsdk::HWM_COMMON_SUCCESS)
    {
        AfxMessageBox(_T("Renamel self error"));
        return;
    }
}