Interface

2026-01-21


errorInfo	ZIM
ZIMDefines

ZIM

Methods

ZIMCombineMessageDetailQueriedCallback

public ZIMCombineMessageDetailQueriedCallback

Result callback for querying merge message details.

Parameters

Name	Type	Description
message	const ZIMCombineMessage&	Merge messages that carry a complete list of merge forward messages.
errorInfo	const ZIMError &	Error information, including error codes and error details.

Details

Result callback for querying merge message details.

ZIMMessageAttachedCallback

public ZIMMessageAttachedCallback

The incoming message object is given a localMessgeID and returned.

Parameters

Name	Type	Description
message	ZIMMessage	The currently sent message object.

Details

Supported version: 2.4.0 and above.

The incoming message object is given a localMessgeID and returned.

Service scenario: Before a message is successfully sent, it can correspond to its localMessageID to implement loading before sending.

Notification time: Triggered after the message is sent and before the message is successfully sent.

ZIMMultipleMediaUploadingProgress

public ZIMMultipleMediaUploadingProgress

Progress callback for sending multiple messages.

Parameters

Name	Type	Description
message	ZIMMultipleMessage	The currently sent message object.
currentFileSize	unsigned long long	The current total uploaded size.
totalFileSize	unsigned long long	The total size of files to be uploaded.
messageInfoIndex	int	The index of the array where the currently uploaded file is located.
currentIndexFileSize	unsigned long long	The uploaded size of the currently uploaded file.
totalIndexFileSize	unsigned long long	The total size of the files currently being uploaded.

Details

Supported versions: 2.19.0 and above.

Detail description: The progress callback for sending multiple messages.

Business scenario: Developers can use this callback to obtain the upload progress of the media files in the multiple message.

Notification timing: When the developer calls the [sendMessage] interface, the callback will be triggered, and will be triggered multiple times during the sending process.

Related interface: Through [sendMessage], the sending progress will be notified through this callback.

ZIMDefines

Methods

ZIMBlacklistUsersAddedCallback

public ZIMBlacklistUsersAddedCallback

Callback for operation results of adding users to the blacklist.

Parameters

Name	Type	Description
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of userInfo that failed to add to the blacklist.
errorInfo	const ZIMError &	Error code.

Use cases: The developer can check whether the queried succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [addUsersToBlacklist] interface.

Related interface: Run the addUsersToBlacklist add user to blacklist

ZIMFriendAddedCallback

public ZIMFriendAddedCallback

Add a friend result callback.

Parameters

Name	Type	Description
friendInfo	ZIMFriendInfo	Friend information.
errorInfo	const ZIMError &	Error code.

Details

The return of the result of adding a friend.

Use cases: The callback is used to determine whether a friend has been added.

Related API: [addFriend],Add friends.

ZIMFriendAliasUpdatedCallback

public ZIMFriendAliasUpdatedCallback

Return results of updating friend alias.

Parameters

Name	Type	Description
friendInfo	ZIMFriendInfo	Friend information.
errorInfo	const ZIMError &	Error code.

Details

Return results of updating friend alias.

Use cases: After updating friend alias, the success or failure can be known through this callback.

Related API: [updateFriendAlias], update friend alias.

ZIMFriendApplicationAcceptedCallback

public ZIMFriendApplicationAcceptedCallback

Accept the returned result of friend application.

Parameters

Name	Type	Description
friendInfo	ZIMFriendInfo	Friend information.
errorInfo	const ZIMError &	Error code.

Details

Accept the returned result of friend application.

Use cases: After accepting a friend application, the success or failure can be known through this callback. Related API: [acceptFriendApplication], Accept friend application.

ZIMFriendApplicationListQueriedCallback

public ZIMFriendApplicationListQueriedCallback

The result of sending a friend application.

Parameters

Name	Type	Description
applicationList	std::vector<ZIMFriendApplicationInfo> &	Friend application information list.
nextFlag	int	The index of the current query anchor point.
errorInfo	const ZIMError &	Error code.

Details

The result of sending a friend application.

Use cases: After sending the friend application operation, the success can be known through the callback.

Related API: [sendFriendApplication],send friend application

ZIMFriendApplicationRejectedCallback

public ZIMFriendApplicationRejectedCallback

Accept the returned result of friend application.

Parameters

Name	Type	Description
userInfo	ZIMUserInfo	Applicant user information.
errorInfo	const ZIMError &	Error code.

Details

Reject the returned result of friend application.

Use cases: After rejecting a friend application, the success or failure can be known through this callback. Related API: [rejectFriendApplication], Reject friend application.

ZIMFriendApplicationSentCallback

public ZIMFriendApplicationSentCallback

The result of sending a friend application.

Parameters

Name	Type	Description
applicationInfo	ZIMFriendApplicationInfo	Friend application information.
errorInfo	const ZIMError &	Error code.

Details

The result of sending a friend application.

Use cases: After sending the friend application operation, the success can be known through the callback.

Related API: [sendFriendApplication],send friend application

ZIMFriendAttributesUpdatedCallback

public ZIMFriendAttributesUpdatedCallback

Return results of updating friend attributes.

Parameters

Name	Type	Description
friendInfo	ZIMFriendInfo	Friend information.
errorInfo	const ZIMError &	Error code.

Details

Return results of updating friend attributes.

Use cases: After updating friend attributes, the success or failure can be known through this callback.

Related API: [updateFriendAttributes], update friend attributes.

ZIMFriendListQueriedCallback

public ZIMFriendListQueriedCallback

The returned result of querying the friends list.

Parameters

Name	Type	Description
friendList	std::vector<ZIMFriendInfo> &	The returned result of querying the friends list.
nextFlag	int	The index of the current query anchor point.
errorInfo	const ZIMError &	Error code.

Details

The returned result of querying the friends list.

Use cases: This callback will tell you if the operation to query the list of friends was successful or not.

Related API: [queryFriendList], Querying the friends list.

ZIMFriendsDeletedCallback

public ZIMFriendsDeletedCallback

Return results of deleting friends.

Parameters

Name	Type	Description
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of user IDs and reasons for failed deletion.
errorInfo	const ZIMError &	Error code.

Details

Return results of deleting friends.

Use cases: After deleting a friend, the success or failure can be known through this callback.

Related API: [deleteFriends], Delete friends in batches.

ZIMFriendsInfoQueriedCallback

public ZIMFriendsInfoQueriedCallback

Return results of querying friend information in batches.

Parameters

Name	Type	Description
friendInfos	const std::vector<ZIMFriendInfo>&	Friend information.
errorUserList	const std::vector<ZIMErrorUserInfo> &	Query the user ID and reason for failed query.
errorInfo	const ZIMError &	Error code.

Details

Return results of querying friend information in batches.

Use cases: After querying friend information in batches, the success or failure can be known through this callback.

Related API: [queryFriendsInfo], Querying friend information in batches.

ZIMFriendsSearchedCallback

public ZIMFriendsSearchedCallback

Search results returned by local friends.

Parameters

Name	Type	Description
friendInfos	std::vector<ZIMFriendInfo> &	Friend application information list.
nextFlag	int	The index of the current query anchor point.
errorInfo	const ZIMError &	Error code.

Details

Search results returned by local friends.

Use cases: This callback will tell you if the operation to query the list of friend application was successful or not.

Related API: [searchLocalFriends], Search results returned by local friends.

ZIMBlacklistUsersRemovedCallback

public ZIMBlacklistUsersRemovedCallback

The callback result of the operation to remove the user from the blacklist.

Parameters

Name	Type	Description
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of userInfo that failed to add.
errorInfo	const ZIMError &	Error code.

Use cases: The developer can check whether the queried succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [removeUsersFromBlacklist] interface.

Related interface: Remove users from the blacklist through [removeUsersFromBlacklist].

ZIMBlacklistQueriedCallback

public ZIMBlacklistQueriedCallback

Query the blacklist result callback.

Parameters

Name	Type	Description
blacklist	const std::vector<ZIMUserInfo> &	Blacklist data stored locally by the SDK.
nextFlag	unsigned int	Description: nextFlag. A value of 0 indicates that the blacklist query is completed. When the value is not 0, it means that the blacklist query is not yet completed. To continue the query, call the query interface again and pass in this nextFlag.
errorInfo	const ZIMError &	Error code.

Use cases: The developer can check whether the queried succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [queryBlacklist] interface.

Related interface: Run the queryBlacklist query blacklist

ZIMFriendsRelationCheckedCallback

public ZIMFriendsRelationCheckedCallback

Check the friend relationship result.

Parameters

Name	Type	Description
errorUserList	const std::vector<ZIMErrorUserInfo> &	Check the list of user IDs and reasons for friend relationship failure.
relationInfos	const std::vector<ZIMFriendRelationInfo> &	Friend relationship information list.
errorInfo	const ZIMError &	Error code.

Details

The result of sending a friend application.

Use cases: After checking the friend relationship, the success or failure can be known through this callback.

Related API: [checkFriendsRelation], check the friend relationship.

ZIMBlacklistCheckedCallback

public ZIMBlacklistCheckedCallback

Blacklist check result callback.

Parameters

Name	Type	Description
isUserInBlacklist	bool	Whether the user is on the blacklist.
errorInfo	const ZIMError &	Error code.

Use cases: Developers can determine whether the check was successful through the [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [checkUserIsInBlacklist] interface.

Related interface: Check whether the user is on the blacklist through [checkUserIsInBlacklist].

ZIMSubscribedUserStatusListQueriedCallback

public ZIMSubscribedUserStatusListQueriedCallback

QuerySubscribedUserStatusList query for the current user subscription list operation results callback.

Parameters

Name	Type	Description
userStatusSubscriptionList	const std::vector< ZIMUserStatusSubscription > &	Subscription information for users in the subscription list.

Details

QuerySubscribedUserStatusList query for the current user subscription list operation results callback.

ZIMUserCustomStatusUpdatedCallback

public ZIMUserCustomStatusUpdatedCallback

The callback of the custom status update.

Parameters

Name	Type	Description
errorInfo	ZIMError	The error message of the custom status update.
customStatus	String	custom status.

Details

The callback of the custom status update.

ZIMUsersStatusQueriedCallback

public ZIMUsersStatusQueriedCallback

Result callback of the queryUsersStatus interface for batch querying user online status.

Parameters

Name	Type	Description
userStatusList	const std::vector< ZIMUserStatus >&	Indicates the online status of the user to be queried.
errorUserList	const std::vector< ZIMErrorUserInfo >&	Query the list of failed users.
errorInfo	const ZIMError &	The query result contains error codes and error information.

Details

Result callback of the queryUsersStatus interface for batch querying user online status.

ZIMUsersStatusSubscribedCallback

public ZIMUsersStatusSubscribedCallback

subscribeUsersStatus Callback for the operation results of the batch subscription interface.

Parameters

Name	Type	Description
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of users who failed to subscribe.
errorInfo	const ZIMError &	Operation result, including error codes and error information.

Details

subscribeUsersStatus Callback for the operation results of the batch subscription interface.

ZIMUsersStatusUnsubscribedCallback

public ZIMUsersStatusUnsubscribedCallback

unsubscribeUsersStatus Callback for canceling the operations of subscribing interfaces in a batch.

Parameters

Name	Type	Description
errorUserList	const std::vector<std::string> &	Cancels the list of failed users.
errorInfo	ZIMError	The result of the batch cancellation operation contains error messages and error codes.

Details

unsubscribeUsersStatus Callback for canceling the operations of subscribing interfaces in a batch.

ZIMTokenRenewedCallback

public ZIMTokenRenewedCallback

Callback of the result of renewing the token.

Parameters

Name	Type	Description
token	const std::string &	The renewed token.
errorInfo	ZIMError	Error code.

Details

After the developer updates the Token, execute the callback of the result.

Use cases: The developer can use [errorCode] in this callback to determine whether the Token was successfully updated.
When to call: This callback is triggered when a developer invokes the [renewToken] interface.
Caution: Renew tokens through [renewToken]. Success or failure to renew tokens will be notified through this callback.

Available since: 1.1.0 or above.

ZIMUsersInfoQueriedCallback

public ZIMUsersInfoQueriedCallback

Query the userInfo callback.

Parameters

Name	Type	Description
userList	const std::vector<ZIMUserFullInfo> &	List of the userInfo queried.
errorUserList	const std::vector<ZIMErrorUserInfo> &	Failed to query the userInfo list.
errorInfo	const ZIMError &	Error code.

Use cases: The developer can check whether the queried succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [queryUsersInfo] interface.

Related interface: Run the queryUsersInfo command to query information.

ZIMUserNameUpdatedCallback

public ZIMUserNameUpdatedCallback

Update the user name callback.

Parameters

Name	Type	Description
userName	std::string	Updated of the user name.
errorInfo	ZIMError	Error code.

Use cases: The developer can check whether the operation succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [updateUserName] interface.

Related interface: [updateUserName].

ZIMUserAvatarUrlUpdatedCallback

public ZIMUserAvatarUrlUpdatedCallback

Callback for updating the user avatar URL.

Parameters

Name	Type	Description
userAvatarUrl	std::string	The updated user avatar URL.
errorInfo	ZIMError	Error code.

Details

Supported versions: 2.3.0 and above.

Detail description: The callback after the developer updates the user avatar URL.

Business scenario: The developer can judge whether the operation is successful through the [errorCode] in the callback.

Notification timing: This callback is triggered when the developer calls the [updateUserAvatarUrl] interface.

Related interface: [updateUserAvatarUrl] .

ZIMUserExtendedDataUpdatedCallback

public ZIMUserExtendedDataUpdatedCallback

Update the user extended data callback.

Parameters

Name	Type	Description
extendedData	std::string	Updated of the user extended data.
errorInfo	ZIMError	Error code.

Use cases: The developer can check whether the operation succeeded by using [errorCode] in this callback.

Notification timing: This callback is triggered when a developer invokes the [updateUserExtendedData] interface.

Related interface: Run the updateUserExtendedData command to query information.

ZIMLoggedInCallback

public ZIMLoggedInCallback

Callback of the login result.

Parameters

Name	Type	Description
errorInfo	ZIMError

Use cases: Developers can use the [errorCode] in the callback to determine whether the login is successful.

Notification timing: When the developer calls the [login] interface, the callback will be triggered.

ZIMLogUploadedCallback

public ZIMLogUploadedCallback

Callback of the log upload result.

Parameters

Name	Type	Description
errorInfo	ZIMError

Use cases: Developers can use the [errorCode] in the callback to determine whether the upload is successful.

Notification timing: When the developer calls the [uploadLog] interface, the callback will be triggered.

Related interface: call log upload via [uploadLog], success or failure will be notified through this callback.

ZIMSelfUserInfoQueriedCallback

public ZIMSelfUserInfoQueriedCallback

Callback result of querying personal user information and rules.

Parameters

Name	Type	Description
selfUserInfo	ZIMSelfUserInfo	Own user information, rule data class.
errorInfo	ZIMError	Contains error codes and error messages.

Details

Callback result of querying personal user information and rules.

ZIMUserOfflinePushRuleUpdatedCallback

public ZIMUserOfflinePushRuleUpdatedCallback

Update the result callback of the user offline push rule.

Parameters

Name	Type	Description
offlinePushRule	ZIMUserOfflinePushRule	Updated offline push rules.
errorInfo	ZIMError	Contains error codes and details.

Details

Update the result callback of the user offline push rule.

ZIMCallInvitationListQueriedCallback

public ZIMCallInvitationListQueriedCallback

Result Callback of querying the call list.

Parameters

Name	Type	Description
callList	const std::vector<ZIMCallInfo> &	Query the list of returned call information
nextFlag	long long	An anchor returned by a paging query that is passed in the next query to continue the query based on the last query.
errorInfo	const ZIMError &	Error information returned from the query.

Details

Result Callback of querying the call list.

ZIMCallingInvitationSentCallback

public ZIMCallingInvitationSentCallback

Callback result of inviting the current call.

Parameters

Name	Type	Description
callID	const std::string &	callID of the current call invitation.
info	const ZIMCallInvitationSentInfo &	Information about callingInvite.
errorInfo	const ZIMError &	Error information. For details, see the Common error code documentation.

Details

Callback result of inviting the current call.

ZIMCallQuitSentCallback

public ZIMCallQuitSentCallback

Quit the callback closure of the call invitation operation.

Parameters

Name	Type	Description
callID	const std::string &	Quit callID.
info	const ZIMCallQuitSentInfo &	Information about quit.
errorInfo	const ZIMError &	Error information,

Details

Quit the callback closure of the call invitation operation.

ZIMCallEndSentCallback

public ZIMCallEndSentCallback

Result callback of ending the call invitation.

Parameters

Name	Type	Description
callID	const std::string &	callID.
info	const ZIMCallInvitationEndedInfo &	End call invitation return information.
errorInfo	const ZIMError &	End call invitation return error information.

Details

Result callback of ending the call invitation.

ZIMCallJoinSentCallback

public ZIMCallJoinSentCallback

Result callback of joining the call invitation.

Name	Type	Description
callID	const std::string &	callID.
info	const ZIMCallJoinSentInfo &	Join call invitation return information.
errorInfo	const ZIMError &	Join call invitation return error information.

ZIMCallInvitationSentCallback

public ZIMCallInvitationSentCallback

Action callback for sending a call invitation.

Parameters

Name	Type	Description
callID	const std::string &	The created call invitation ID.
info	ZIMCallInvitationSentInfo	Send a call invitation message.
errorInfo	ZIMError	Error code for sending call invitation. 0 means sending the call invitation successfully, non-0 means sending the call invitation failed. If there is a failure to send a call invitation, the developer should check the official website error code documentation for solutions.

Related APIs: [callInvite], send a call invitation.

ZIMCallCancelSentCallback

public ZIMCallCancelSentCallback

Callback for the action to cancel the call invitation.

Parameters

Name	Type	Description
callID	const std::string &	Call ID
errorInvitees	const std::vector<std::string> &	The user who failed to cancel the call invitation.
errorInfo	ZIMError	Error code to cancel the call invitation. 0 means canceling the call invitation successfully, non-0 means canceling the call invitation failed. If there is a failure to cancel the call invitation, the developer should check the official website error code document to query the solution.

Related APIs: [callCancel], cancel the call invitation.

ZIMCallAcceptanceSentCallback

public ZIMCallAcceptanceSentCallback

Action callback for accepting call invitations.

Parameters

Name	Type	Description
callID	const std::string &	Call ID
errorInfo	ZIMError	Error code to accept call invitation. 0 means accepting the call invitation successfully, non-0 means accepting the call invitation failed. If there is a failure to accept the call invitation, the developer should check the official website error code documentation for solutions.

Related APIs: [callAccept], accept the call invitation.

ZIMCallRejectionSentCallback

public ZIMCallRejectionSentCallback

Action callback for rejecting a call invitation.

Parameters

Name	Type	Description
callID	const std::string &	Call ID
errorInfo	ZIMError	Error code to reject call invitation. 0 means rejecting the call invitation successfully, non-0 means failing to reject the call invitation. If there is a failure to reject the call invitation, the developer should check the official website error code documentation for solutions.

Related APIs: [callReject], rejects the call invitation.

ZIMGroupCreatedCallback

public ZIMGroupCreatedCallback

Returns the result of creating a group.

Parameters

Name	Type	Description
groupInfo	const ZIMGroupFullInfo&	groupInfo.
userList	const std::vector<ZIMGroupMemberInfo>	user list.
errorUserList	const std::vector<ZIMErrorUserInfo>	errorUserList.
errorInfo	ZIMError	Error code for group creation. 0 means the group creation is successful, non-0 means the group creation fails. If there is a failure to create a group, the developer should check the official website error code document to query the solution.

Details

Returns the result of the group creation operation.

Use cases: After a group creation operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The result is returned after the group creation operation is complete.

Related API: [createGroup] : creates a group.

ZIMGroupsSearchedCallback

public ZIMGroupsSearchedCallback

Returns the result of search a group.

Parameters

Name	Type	Description
groupSearchInfoList	const std::vector<ZIMGroupSearchInfo> &	groupInfo.
nextFlag	unsigned int	Pagination retrieval flag, anchor for searching the next page.
errorInfo	const ZIMError &	Error codes for group search. 0 represents a successful group search, and non-zero indicates a failed group search. If a group search fails, developers should refer to the official website's error code documentation for solutions.

Details

Returns the result of a group search operation.

Use cases: After performing a group search operation, whether it is successful or not can be known through this callback.

Related API: [searchLocalGroups], search for groups.

ZIMGroupMembersSearchedCallback

public ZIMGroupMembersSearchedCallback

Returns the result of search a group members.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
userList	const std::vector<ZIMGroupMemberInfo> &	The search result list of group members.
nextFlag	unsigned int	Pagination retrieval flag, anchor for searching the next page.
errorInfo	const ZIMError &	Error codes for searching group members. 0 represents a successful search for group members, and non-zero indicates a failed search for group members. If a search for group members fails, developers should refer to the official website's error code documentation for solutions.

Details

Returns the result of a group member search operation.

Use cases: After performing a group member search operation, whether it is successful or not can be known through this callback.

Related API: [searchLocalGroupMembers], search for group members.

ZIMGroupJoinedCallback

public ZIMGroupJoinedCallback

Returns the result of joining the group.

Parameters

Name	Type	Description
groupInfo	ZIMGroupFullInfo	groupInfo.
errorInfo	ZIMError	Error code to join the group. 0 means joining the group successfully, non-0 means joining the group failed. If there is a failure to join the group, the developer should check the official website error code document to query the solution.

Details

Returns the result of the group join operation.

Use cases: After a group join operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The result of the group join operation is returned.

Related API:[joinGroup] : joins a group. [leaveGroup], leave the group.

ZIMGroupLeftCallback

public ZIMGroupLeftCallback

Return of the result of leaving the group.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
errorInfo	ZIMError	Error code for leaving the group. 0 means leaving the group successfully, non-0 means leaving the group failed. If there is a failure to leave the group, the developer should check the official website error code document to query the solution.

Details

Returns the result of the group departure operation.

Use cases: After a group exit operation is performed, the success or failure can be determined by the callback.
When to call /Trigger: The result of the group departure operation is returned.

Related API:[leaveGroup], leave the group. [joinGroup], enter the group.

ZIMGroupDismissedCallback

public ZIMGroupDismissedCallback

Returns the result of disbanding the group.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
errorInfo	ZIMError	The error code for disbanding the group. 0 means that the group is successfully disbanded, and non-0 means that the group failed to be disbanded. If there is a failure to dissolve the group, the developer should check the official website error code document to find the solution.

Details

Returns the result of the group dismiss operation.

Use cases: After a group disband operation is performed, the success of the operation can be determined by the callback.
When to call /Trigger: The result of the group disband operation is returned.

Related API: [createGroup],creates a group. [dismissGroup],dismissGroup.

ZIMGroupUsersInvitedCallback

public ZIMGroupUsersInvitedCallback

The result of the user being invited to the group is returned.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
userList	const std::vector<ZIMGroupMemberInfo> &	user list.
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of users who failed to invite.
errorInfo	ZIMError	Error code for inviting users to join the group. 0 means to invite the user to join the group, non-0 means that the invitation to join the group fails. If there is a failure to invite users to join the group, the developer should check the official website error code document to query the solution.

Details

Returns the result of inviting the user to join the group.

Use cases: After a user is invited to a group, the success or failure can be determined by the callback.
When to call /Trigger: Results are returned after the user is invited to the group.

Related API:[inviteUsersIntoGroup] invites users to join the group.

ZIMGroupMemberKickedCallback

public ZIMGroupMemberKickedCallback

Returns the result of kicking out a group member.

Parameters

Name	Type	Description
kickedUserIDList	const std::vector<std::string>	List of kicked members.
errorUserList	const std::vector<ZIMErrorUserInfo>	Bad user list.
errorInfo	ZIMError	Error code for kicking out a group member. 0 means that the group member was successfully kicked out, and non-0 means that the group member failed to be kicked out. If a group member is kicked out, the developer should check the official website error code document to query the solution.

Details

Returns the result of the kick out group member operation.

Use cases: After a group member is kicked out, the success or failure can be determined by the callback.
When to call /Trigger: The result is returned after the group member is kicked out.

Related API:[kickGroupMembers] Kick out group members.

ZIMGroupOwnerTransferredCallback

public ZIMGroupOwnerTransferredCallback

Returns the result of the group owner assignment.

Parameters

Name	Type	Description
groupID	const std::string &	groupID.
toUserID	const std::string &	userID.
errorInfo	ZIMError	The error code of the transfer group owner. 0 means the transfer of the group owner is successful, non-0 means the transfer of the group owner failed. If the transfer of the group owner fails, the developer should check the official website error code document to query the solution.

Details

Returns the result of the group master transfer operation.

Use cases: After a group master transfer operation is performed, the success of the operation can be determined by this callback.
When to call /Trigger: The result of the group master transfer operation is returned.

Related API:[transferGroupOwner], group master transfer.

ZIMGroupAliasUpdatedCallback

public ZIMGroupAliasUpdatedCallback

Returns the result of the group alias update.

Parameters

Name	Type	Description
groupID	const std::string &	ID of the group.
groupAlias	const std::string &	Alias of the group.
errorInfo	ZIMError	Update the error code of the group alias. 0 means the update succeeds, non-0 means the update fails. If there is a failure to update, please check the official error code document for the solution.

Details

Return result of group alias update operation.

Use cases: After a group alias update operation is performed, the success or failure can be determined by this callback.

When to

Trigger: The result of the group alias update operation is returned.
Related APIs: [updateGroupAlias], the group alias is updated.

ZIMGroupNameUpdatedCallback

public ZIMGroupNameUpdatedCallback

Returns the result of the group name update.

Parameters

Name	Type	Description
groupID	const std::string &	groupID.
groupName	const std::string &	groupName.
errorInfo	ZIMError	Update the error code of the group name. 0 means the update of the group name succeeds, non-0 means the update of the group name fails. If there is a failure to update the group name, the developer should check the official website error code document to query the solution.

Details

Return result of group name update operation.

Use cases: After a group name update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The result of the group name update operation is returned.
Related APIs: [updateGroupName], the group name is updated.

ZIMGroupMutedCallback

public ZIMGroupMutedCallback

Returns the result of the group mute info update.

Parameters

Name	Type	Description
groupID	const std::string &	groupID.
isMute	bool	Group mute or lift group mute.
mutedInfo	ZIMGroupMuteInfo	Group mute info.
errorInfo	ZIMError	Update the error code of the group mute info. 0 means the update of the group mute info succeeds, non-0 means the update of the group mute info fails. If there is a failure to update the group mute info, the developer should check the official website error code document to query the solution.

Details

Return result of group mute info update operation.

Use cases: After a group mute info update operation is performed, the success or failure can be determined by this callback.

When to

Trigger: The result of the group mute info update operation is returned.
Related APIs: [muteGroup], the group mute info is updated.

ZIMGroupMembersMutedCallback

public ZIMGroupMembersMutedCallback

Returns the result of the group members mute info update.

Parameters

Name	Type	Description
groupID	const std::string &	groupID.
isMute	bool	Group members mute or lift group members mute.
duration	int	Duration of group member mute, in seconds.
mutedUserIDs	const std::vector<std::string> &	List of group member IDs successfully modified to mute status.
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of group members failed to modify to mute status.
errorInfo	ZIMError	Update the error code of the group members mute info. 0 means the update of the group members mute info succeeds, non-0 means the update of the group members mute info fails. If there is a failure to update the group members mute info, the developer should check the official website error code document to query the solution.

Details

Return result of group members mute info update operation.

Use cases: After a group members mute info update operation is performed, the success or failure can be determined by this callback.

When to

Trigger: The result of the group members mute info update operation is returned.
Related APIs: [muteGroupMembers], the group members mute info is updated.

ZIMGroupAvatarUrlUpdatedCallback

public ZIMGroupAvatarUrlUpdatedCallback

Returns the result of the group avatar URL update.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
groupAvatarUrl	const std::string &	Group avatar URL.
errorInfo	ZIMError	Update the error code of the group avatar url. 0 means the update succeeds, non-0 means the update of the group name fails. If there is a failure, the developer should check the official website error code document to query the solution.

When to call /Trigger: The result will be returned after the group avatar URL update operation is complete.
Related APIs: [updateGroupAvatarUrl].

ZIMGroupNoticeUpdatedCallback

public ZIMGroupNoticeUpdatedCallback

The return of the results of the group announcement update.

Parameters

Name	Type	Description
groupNotice	const std::string &	Group announcement.
errorInfo	ZIMError	Update the error code of the group announcement. 0 means the update group announcement is successful, non-0 means the update group announcement fails. If the update group announcement fails, the developer should check the official website error code document to query the solution.

Details

Group announcement returns the result of the update operation.

Use cases: After a group bulletin update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The group bulletin is returned after the update operation is complete.
Related APIs: [updateGroupNotice], the group notice is updated.

ZIMGroupJoinModeUpdatedCallback

public ZIMGroupJoinModeUpdatedCallback

The return of the results of the group verification mode update.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
mode	ZIMGroupJoinMode	Group verification mode.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Group verification mode returns the result of the update operation.

Use cases: After a group verification mode update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The group verification mode is returned after the update operation is complete.
Related APIs: [updateGroupJoinMode], the group verification mode is updated.

ZIMGroupInviteModeUpdatedCallback

public ZIMGroupInviteModeUpdatedCallback

The return of the results of the group verification mode update.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
mode	ZIMGroupInviteMode	Group verification mode.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Group verification mode returns the result of the update operation.

Use cases: After a group verification mode update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The group verification mode is returned after the update operation is complete.
Related APIs: [updateGroupInviteMode], the group verification mode is updated.

ZIMGroupBeInviteModeUpdatedCallback

public ZIMGroupBeInviteModeUpdatedCallback

The return of the results of the group verification mode update.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
mode	ZIMGroupBeInviteMode	Group verification mode.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Group verification mode returns the result of the update operation.

Use cases: After a group verification mode update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The group verification mode is returned after the update operation is complete.
Related APIs: [updateGroupBeInviteMode], the group verification mode is updated.

ZIMGroupJoinApplicationSentCallback

public ZIMGroupJoinApplicationSentCallback

The return of the results of the group join application sent.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of sent the group join application.

Use cases: After sent the application to join the group, the success or failure can be determined by this callback.
Related APIs: [sendGroupJoinApplication], the group join application sent.

ZIMGroupJoinApplicationAcceptedCallback

public ZIMGroupJoinApplicationAcceptedCallback

The return of the results of the group join application accept.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
userID	std::string	Applicant user ID.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of accept the group join application.

Use cases: After accept the application to join the group, the success or failure can be determined by this callback.
Related APIs: [acceptGroupJoinApplication], the group join application accept.

ZIMGroupJoinApplicationRejectedCallback

public ZIMGroupJoinApplicationRejectedCallback

The return of the results of the group join application reject.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
userID	std::string	Applicant user ID.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of reject the group join application.

Use cases: After reject the application to join the group, the success or failure can be determined by this callback.
Related APIs: [rejectGroupJoinApplication], the group join application reject.

ZIMGroupInviteApplicationsSentCallback

public ZIMGroupInviteApplicationsSentCallback

The return of the results of the group invite application sent.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
errorUserList	std::vector<ZIMErrorUserInfo>	List of users whose invitation failed.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of sent the group invite application.

Use cases: After sent the invite application to the group, the success or failure can be determined by this callback.
Related APIs: [sendGroupInviteApplications], the group invite application sent.

ZIMGroupInviteApplicationAcceptedCallback

public ZIMGroupInviteApplicationAcceptedCallback

The return of the results of the group invite application accept.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
inviterUserID	std::string	Inviter user ID.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of accept the group invite application.

Use cases: After accept the invite application to the group, the success or failure can be determined by this callback.
Related APIs: [acceptGroupInviteApplication], the group invite application accept.

ZIMGroupApplicationListQueriedCallback

public ZIMGroupApplicationListQueriedCallback

Query the callback of group application list.

Parameters

Name	Type	Description
applicationList	std::vector<ZIMGroupApplicationInfo>	Group application list.
nextFlag	unsigned int	The next flag.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return of group application list query results..

Use cases: After querying the group application list, the success or failure can be determined by this callback.
Related APIs: [queryGroupApplicationList], query group application list.

ZIMGroupInviteApplicationRejectedCallback

public ZIMGroupInviteApplicationRejectedCallback

The return of the results of the group invite application accept.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
inviterUserID	std::string	Inviter user ID.
errorInfo	ZIMError	Error code for update operation. 0 means the update is successful, non-0 means the update fails.

Details

Return the operation result of reject the group invite application.

Use cases: After reject the invite application to the group, the success or failure can be determined by this callback.
Related APIs: [rejectGroupInviteApplication], the group invite application reject.

ZIMGroupInfoQueriedCallback

public ZIMGroupInfoQueriedCallback

Returns the result of querying group information.

Parameters

Name	Type	Description
groupInfo	ZIMGroupFullInfo	groupInfo.
errorInfo	ZIMError	Error code for querying group information. 0 means the query group information is successful, non-0 means the query group information fails. If there is a failure to query group information, the developer should check the official website for the error code document query solution.

Details

Returns the result of the group dismiss operation.

Use cases: After a group disband operation is performed, the success of the operation can be determined by the callback.
When to call /Trigger: The result of the group disband operation is returned.
Related APIs: [createGroup],creates a group. [dismissGroup],dismissGroup.

ZIMGroupListQueriedCallback

public ZIMGroupListQueriedCallback

Returns the results of the query group list.

Parameters

Name	Type	Description
groupList	const std::vector<ZIMGroupInfo>	groupList.
errorInfo	ZIMError	Query the error code of the group list. 0 means the query group list succeeds, non-0 means the query group list fails. If there is a failure to query the group list, the developer should check the official website for the error code document query solution.

Details

Returns the group list query result.

Use cases: The success of a group list query can be determined by this callback.
When to call /Trigger: The result of the group list query is returned.
Related APIs: [queryGroupList] to query the group list.

ZIMGroupAttributesOperatedCallback

public ZIMGroupAttributesOperatedCallback

Returns the result of a group attribute operation.

Parameters

Name	Type	Description
groupID	const std::string &	groupID.
errorKeys	std::vector<std::string>	errorKeys.
errorInfo	ZIMError	Set the error code of the group attribute. 0 means the group attribute setting is successful, non-0 means the group attribute setting fails. If there is a failure to set the group properties, the developer should check the official website error code documentation for solutions.

Details

Returns the result of the group property operation.

Use cases: This callback tells you whether a custom property operation is successful.
When to call /Trigger: The result of the group property operation is returned.
Related APIs: [setGroupAttributes], set the room properties. [deleteGroupAttributes], delete the room attribute.

ZIMGroupAttributesQueriedCallback

public ZIMGroupAttributesQueriedCallback

The return of query group attribute results.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
groupAttributes	std::unordered_map<std::string, std::string>	groupAttributes.
errorInfo	ZIMError	Error code for querying group attributes. 0 means the query group attribute succeeds, non-0 means the query group attribute fails. If there is a failure to query group properties, the developer should check the official website for the error code document query solution.

Details

Returns the result of group attribute query.

Use cases: This callback is used to determine the success of a custom property query.
When to call /Trigger: Group attribute query results are returned.
Related APIs: [queryGroupAttributes], query room attributes.

ZIMGroupMemberRoleUpdatedCallback

public ZIMGroupMemberRoleUpdatedCallback

Returns the result of the member role update.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
forUserID	const std::string	userID.
role	int	role.
errorInfo	ZIMError	Error code for group member role update. 0 means the group member role update is successful, non-0 means the group member role update fails. If the group member role update fails, the developer should check the official website error code document to query the solution.

Details

Return of the result of the member role update operation.

Use cases: After a member role update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The result of the member role update operation is returned.
Related APIs: [setGroupMemberRole], the member role is updated.

ZIMGroupMemberNicknameUpdatedCallback

public ZIMGroupMemberNicknameUpdatedCallback

Returns the result of the group member's nickname update.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
forUserID	const std::string	userID.
nickname	const std::string	userNickname.
errorInfo	ZIMError	Set the error code of the group member's nickname. 0 means setting the group member's nickname successfully, non-0 means setting the group member's nickname failed. If there is a failure to set the group member's nickname, the developer should check the official website error code document to query the solution.

Details

Return result of group member nickname update operation.

Use cases: After a group member nickname update operation is performed, the success or failure can be determined by this callback.
When to call /Trigger: The result of the group member nickname update operation is returned.
Related APIs: [setGroupMemberNickname], the nickname of the group member is updated.

ZIMGroupMemberInfoQueriedCallback

public ZIMGroupMemberInfoQueriedCallback

Returns the result of the group member query.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID.
userInfo	ZIMGroupMemberInfo	Group member information.
errorInfo	ZIMError	Query the error code of group members. 0 means querying group members successfully, non-0 means querying group members failed. If there is a failure to query group members, the developer should check the official website for the error code document query solution.

Details

Return of group member query results.

Use cases: After a group member query is performed, the success or failure can be determined by this callback.
When to call /Trigger: Group member query results are returned.
Related APIs: [queryGroupMemberInfo], queryGroupMemberInfo.

ZIMGroupMemberListQueriedCallback

public ZIMGroupMemberListQueriedCallback

Returns the result of querying the group member list.

Parameters

Name	Type	Description
userList	const std::vector<ZIMGroupMemberInfo>	user list.
nextFlag	int	nextFlag.
errorInfo	ZIMError	Error code for querying the group member list. 0 means that the query of the group member list succeeds, and non-0 means that the query of the group member list fails. If there is a failure to query the group member list, the developer should check the official website for the error code document query solution.

Details

Returns the result of querying the group member list.

Use cases: After querying the group member list, you can use the callback to determine whether the query is successful.
When to call /Trigger: The result is displayed after the group member list is queried.
Related APIs: [queryGroupMemberList], query the group member list.

ZIMGroupMemberMutedListQueriedCallback

public ZIMGroupMemberMutedListQueriedCallback

Returns the result of querying the group muted member list.

Parameters

Name	Type	Description
groupID	const std::string &	Group ID for modifying the mute status of group members.
nextFlag	unsigned long long	nextFlag.
userList	const std::vector<ZIMGroupMemberInfo>	user list.
errorInfo	ZIMError	Error code for querying the group muted member list. 0 means that the query of the group muted member list succeeds, and non-0 means that the query of the group muted member list fails. If there is a failure to query the group muted member list, the developer should check the official website for the error code document query solution.

Details

Returns the result of querying the group muted member list.

Use cases: After querying the group muted member list, you can use the callback to determine whether the query is successful.

When to trigger: The result is displayed after the group muted member list is queried.

Related APIs: [queryGroupMemberMutedList], query the group muted member list.

ZIMGroupMemberCountQueriedCallback

public ZIMGroupMemberCountQueriedCallback

Returns the result of querying the group member count.

Parameters

Name	Type	Description
groupID	String	user count.
count	int	nextFlag.
errorInfo	ZIMError	Error code for querying the group member count. 0 means that the query of the group member count succeeds, and non-0 means that the query of the group member count fails. If there is a failure to query the group member count, the developer should check the official website for the error code document query solution.

Details

Returns the result of querying the group member count.

Use cases: After querying the group member count, you can use the callback to determine whether the query is successful.
When to call /Trigger: The result is displayed after the group member count is queried.

Related API:[queryGroupMemberCount], query the group member count.

ZIMConversationPinnedListQueriedCallback

public ZIMConversationPinnedListQueriedCallback

Callback for querying the pinned conversation list.

Parameters

Name	Type	Description
conversationList	const std::vector<std::shared_ptr<ZIMConversation>> &	Conversation pinned list.
errorInfo	ZIMError	Error info for querying the conversation pinned list. 0 means querying the session list succeeds, non-0 means querying the session list fails. If there is a failure to query the call list, the developer should check the official website error code document to query the solution.

Details

After the conversation pinned list is queried, the callback is used to return the query result.

Use cases: The logic after the pinned conversation list query can be done in this callback.
When to call /Trigger: Triggered when the conversation pinned list is queried.

Available since: 2.8.0 and above.

ZIMConversationPinnedStateUpdatedCallback

public ZIMConversationPinnedStateUpdatedCallback

Callback for conversation pinned state updated.

Parameters

Name	Type	Description
conversationID	const std::string &	Conversation ID.
conversationType	ZIMConversationType	Conversation type.
errorInfo	ZIMError	Error code for updating session pin status. 0 means updating the top status of the session was successful, and non-zero means updating the top status of the session failed. If there is a failure to update the top status of the session, the developer should check the error code document on the official website to find the solution.

Details

After updating the pinned status of the conversation, the query result is returned through this callback.

Use cases: The logic after updating the pinned status of the conversation can be done in this callback.
When to call /Trigger: Triggered after updating the pinned status of the conversation.

Available since: 2.8.0 and above.

ZIMConversationQueriedCallback

public ZIMConversationQueriedCallback

Conversation query callback.

Parameters

Name	Type	Description
conversation	std::shared_ptr<ZIMConversation> &	Conversation object.
errorInfo	ZIMError	The error info of the conversation query. 0 indicates that the query conversation is successful, and non-zero indicates that the query conversation fails. If the query conversation fails, the developer should check the official website error code document query solution.

Details

After the conversation is queried, the callback is used to return the query result.

Use cases: The logic after the conversation query can be done in this callback.
When to call /Trigger: Triggered when the conversation is queried.

Available since: 2.8.0 and above.

ZIMConversationListQueriedCallback

public ZIMConversationListQueriedCallback

Session list query callback.

Parameters

Name	Type	Description
conversationList	std::vector<std::shared_ptr<ZIMConversation>>	Session list.
errorInfo	ZIMError	Error code for querying the conversation list. 0 means querying the session list succeeds, non-0 means querying the session list fails. If there is a failure to query the call list, the developer should check the official website error code document to query the solution.

Details

After the session list is queried, the callback is used to return the query result.

Use cases: The logic after the session list query can be done in this callback.
When to call /Trigger: Description Triggered when the session list is queried.
Related APIs: [queryConversationList].

Available since: 2.0.0 and above.

ZIMConversationDeletedCallback

public ZIMConversationDeletedCallback

Callback for conversation deletion.

Parameters

Name	Type	Description
conversationID	const std::string &	Conversation ID.
conversationType	ZIMConversationType	Conversation type.
errorInfo	ZIMError	Delete the error code of the call. 0 means that the session was deleted successfully, non-0 means that the session was deleted failed. If the deletion of the call fails, the developer should check the official website error code document to query the solution.

Details

After a session is deleted, the deletion result is returned using this callback.

Use cases: You can do the deleted session logic in this callback.
When to call /Trigger: Description Triggered after the session was deleted.
Related APIs: [deleteConversation].

Available since: 2.0.0 and above.

ZIMConversationDraftSetCallback

public ZIMConversationDraftSetCallback

Sets the callback for the session draft.

Parameters

Name	Type	Description
conversationID	std::string	Conversation ID.
conversationType	ZIMConversationType	Conversation type.
errorInfo	ZIMError	The error code for the set session draft. 0 indicates that the session draft is set successfully, and non-0 indicates that the session draft fails to be set. If the setup session draft fails, the developer should check the error code documentation on the official website for a solution.

Details

After setting the session draft, the result is returned through this callback.

Use cases: The logic after the session draft can be set up in this callback.
When to call /Trigger: Triggers after setting session draft.
Related APIs: [setConversationDraft].

Available since: 2.14.0 and above.

ZIMConversationTotalUnreadMessageCountQueriedCallback

public ZIMConversationTotalUnreadMessageCountQueriedCallback

Query conversation unread total count callback.

Parameters

Name	Type	Description
unreadMessageCount	unsigned int	Conversations unread message total count.
errorInfo	ZIMError	The error code for the query operation.

Trigger: Triggers after queried conversation total unread message count.

Available since: 2.17.0 and above.

When to

ZIMConversationsAllDeletedCallback

public ZIMConversationsAllDeletedCallback

Callback for conversations deletion.

Parameters

Name	Type	Description
errorInfo	ZIMError	Example Delete error codes for all sessions. 0 indicates that all sessions are deleted successfully. If the value is not 0, all sessions fail to be deleted. If all sessions fail to be deleted, the developer should check the error code documentation on the official website for a solution.

Details

After all sessions are deleted, the callback returns the deletion result.

Use cases: Logic after all sessions are deleted can be performed in the callback.
When to call /Trigger: Triggered after all sessions are deleted.
Related APIs: [deleteAllConversations].

Available since: 2.12.0 and above.

ZIMConversationTotalUnreadMessageCountClearedCallback

public ZIMConversationTotalUnreadMessageCountClearedCallback

Callback for sessions unread clearing.

Parameters

Name	Type	Description
errorInfo	ZIMError	Clear error codes for all unread sessions. 0 indicates that the number of unread sessions is successfully cleared. If the number is not 0, the number of unread sessions fails to be cleared. If you fail to clear the total number of unread sessions, the developer should check the error code documentation on the official website for a solution.

Details

This callback returns the result of clearing all sessions if the session is not read.

Use cases: You can do clear all unread logic in this callback.
When to call /Trigger: Triggered after clearing all sessions unread.
Related APIs: [clearConversationTotalUnreadMessageCount].

Available since: 2.12.0 and above.

ZIMConversationUnreadMessageCountClearedCallback

public ZIMConversationUnreadMessageCountClearedCallback

Callback for session unread clearing.

Parameters

Name	Type	Description
conversationID	const std::string &	Conversation ID.
conversationType	ZIMConversationType	Conversation type.
errorInfo	ZIMError	Clears the error code for the number of unread calls. 0 means clearing the unread number of the session successfully, non-0 means the clearing the unread number of the session failed. If there is a failure to clear the number of unread calls, the developer should check the official website error code document to query the solution.

Details

This callback returns the result of clearing a session if the session is not read.

Use cases: You can do clear unread logic in this callback.
When to call /Trigger: Triggered after clearing session unread.
Related APIs: [clearConversationUnreadMessageCount].

Available since: 2.0.0 and above.

ZIMConversationMarkSetCallback

public ZIMConversationMarkSetCallback

Callback for conversation mark set.

Parameters

Name	Type	Description
failedConversationInfos	const std::vector<ZIMConversationBaseInfo> &	Setting failed conversation brief information.
errorInfo	ZIMError	Conversation mark operation error codes. 0 represents a successful conversation mark operation, while non-zero values indicate a failed conversation mark operation. If a conversation mark operation fails, developers should refer to the official error code documentation for solution.

Details

The result of setting conversation marks.

When to

Trigger: Triggered after setting conversation marks.
Related APIs: [setConversationMark].

Available since: 2.17.0 and above.

ZIMMessageInsertedCallback

public ZIMMessageInsertedCallback

Callback of the result of inserting the message.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	Message object.
errorInfo	ZIMError	Insert the error code for the local message. 0 means inserting the message successfully, non-0 means inserting the message failed. If there is a failure to insert the message, the developer should check the https://doc-zh.zego.im/article/11606 to query the solution.

Related APIs: Insert local messages through [insertMessageToLocalDB], and the success or failure will be notified through this callback.

ZIMMessageImportedCallback

public ZIMMessageImportedCallback

Callback of the result of importing the message.

Parameters

Name	Type	Description
errorInfo	const std::shared_ptr<ZIMMessage> &	The error code for importing the message. 0 indicates that the message is successfully imported. If the message is not 0, the message fails to be imported.

Related APIs: Import messages by [importLocalMessages], success or failure is notified by this callback.

ZIMMessageExportedCallback

public ZIMMessageExportedCallback

Callback of the result of exporting the message.

Parameters

Name	Type	Description
errorInfo	const std::shared_ptr<ZIMMessage> &	The error code for exporting the message. 0 indicates that the message is successfully exported. If the message is not 0, the message fails to be exported.

Related APIs: Export messages by [exportLocalMessages], success or failure is notified by this callback.

ZIMFileCacheClearedCallback

public ZIMFileCacheClearedCallback

Clears the callback of the local cache result.

Parameters

Name	Type	Description
errorInfo	const std::shared_ptr<ZIMMessage> &	Clear cached error codes. 0 indicates that the cache is successfully cleared. If the value is not 0, the cache fails to be cleared.

Related APIs: Run the [clearLocalFileCache] command to insert a local message. Whether the message is inserted successfully or not is notified by this callback.

ZIMFileCacheQueriedCallback

public ZIMFileCacheQueriedCallback

Callback for querying the results of the local cache.

Parameters

Name	Type	Description
fileCacheInfo	ZIMFileCacheInfo	Cache information.
errorInfo	ZIMError	Example Query the cache error code. 0 indicates that the cache is successfully queried. If the value is not 0, the cache fails to be queried.

Related APIs: The local cache is queried using [queryLocalFileCache]. Success or failure is notified by this callback.

ZIMMessageReactionAddedCallback

public ZIMMessageReactionAddedCallback

The addition of return for message reactions.

Parameters

Name	Type	Description
reaction	const ZIMMessageReaction &	reaction data.
errorInfo	const ZIMError &	The error code of the message reaction addition. 0 represents the operation success, non-0 represents the operation failure, please refer to the Error codes doc (https://docs.zegocloud.com/article/13791) for solutions.

Trigger: After reacting to a message.

Related API: [addMessageReaction]

ZIMMessageReactionDeletedCallback

public ZIMMessageReactionDeletedCallback

The delete of return for message reactions.

Parameters

Name	Type	Description
reaction	const ZIMMessageReaction &	reaction data.
errorInfo	const ZIMError &	The error code of the message reaction addition. 0 represents the operation success, non-0 represents the operation failure, please refer to the Error codes doc (https://docs.zegocloud.com/article/13791) for solutions.

Trigger: After deleting a message reaction.

Related API: [deleteMessageReaction]

ZIMMessageReactionUserListQueriedCallback

public ZIMMessageReactionUserListQueriedCallback

The return of the query for the details of the reaction.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	message.
userList	const std::vector<ZIMMessageReactionUserInfo> &	Query the detailed list of users' reactions.
reactionType	const std::string &	Types of reaction.
nextFlag	const long long	Query anchor, used for the next page to be passed to [ZIMMessageReactionUserQueryConfig] for querying.
totalCount	const unsigned int	The total number of users who reaction.
error	const ZIMError &	错误信息

Trigger: After querying the user info related to a message reaction.

Related API: [queryMessageReactionUserList]

ZIMMessageRepliedListQueriedCallback

public ZIMMessageRepliedListQueriedCallback

The callback for querying the reply message list result.

Name	Type	Description
messageList	const std::vector<ZIMMessage> &	List of messages retrieved.
nextFlag	const long long	Query anchor, used for the next page to be passed to [ZIMMessageRepliedListQueryConfig] for querying.
rootRepliedInfo	ZIMMessageRootRepliedInfo	Reply information for the root message.
error	const ZIMError &	error info.

ZIMMessageEditedCallback

public ZIMMessageEditedCallback

Callback of the result of editing the message.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	The edited message object, from which parameters such as editedTime and editorUserID can be obtained.
errorInfo	ZIMError	The error code of the edited message.

Details

Supported Versions: 2.20.0 and above.

Detail description: The callback for the result of editing the message.

Business scenario: The developer can judge whether the editing is successful through the [errorCode] in the callback.

Notification timing: This callback is triggered when the developer calls the [editMessage] interfaces.

ZIMMessagePinnedCallback

public ZIMMessagePinnedCallback

Callback of the result of the message to be pinned or unpinned.

Parameters

Name	Type	Description
errorInfo	ZIMError	The error code of the pinned or unpinned message.
sequence	zim_sequence	Context that identifies which invocation triggered this callback.

Details

Supported versions: 2.25.0 and above.

Detailed description: The callback for the result of pinning or unpinning a message.

Business scenario: Developers can determine whether the operation was successful via the [errorCode] in this callback.

Notification timing: This callback is triggered when the developer calls the [pinMessage] interface.

ZIMMessageSentCallback

public ZIMMessageSentCallback

Callback of the result of sending the message.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	The sent message object, from which parameters such as messageID can be obtained. If the sending fails, the messageID parameter in the message will be an empty string.
errorInfo	ZIMError	The error code of the sent message. 0 means sending the message successfully, non-0 means sending the message failed. If there is a failure to send a message, the developer should check the official website error code document to query the solution.

Details

Supported Versions: 1.1.0 and above.

Detail description: The callback for the result of sending the message.

Business scenario: The developer can judge whether the sending is successful through the [errorCode] in the callback.

Notification timing: This callback is triggered when the developer calls the [sendPeerMessage] and [sendRoomMessage] interfaces.

Related interfaces: Send messages through [sendPeerMessage] and [sendRoomMessage], and the success of sending messages will be notified through this callback.

ZIMSendingMessageCancelledCallback

public ZIMSendingMessageCancelledCallback

Callback of the result of cancel sending the message.

Supported Versions: 2.22.0 and above.

Detail description: The callback for the result of cancel sending the message.

Business scenario: The developer can judge whether the cancel sending is successful through the [errorCode] in the callback.

Notification timing: This callback is triggered when the developer calls the [cancelSendingMessage] interfaces.

ZIMConversationMessageReceiptReadSentCallback

public ZIMConversationMessageReceiptReadSentCallback

Callback interface for setting the read receipt conversation.

Parameters

Name	Type	Description
conversationID	const std::string &	ConversationID.
conversationType	ZIMConversationType	Conversation Type.
errorInfo	ZIMError	Set the error code of the receipt conversation read. 0 indicates that the setting is successful, and non-zero indicates that the setting fails. If the setting fails, the developer should check the official website error code document for solutions.

Details

Set the callback interface for the read receipt conversation.

Use cases: Developers can judge whether the sending is successful through [errorCode] in the callback.

Notification timing: When the developer calls the [sendConversationMessageReceiptRead] interface, this callback will be triggered.

Related APIs: The success or failure of the conversation read result set by [sendConversationMessageReceiptRead] will be notified through this callback.

Available since: 2.5.0 and above.

ZIMMessageReceiptsReadSentCallback

public ZIMMessageReceiptsReadSentCallback

Callback interface for setting the read receipt message.

Parameters

Name	Type	Description
conversationID	const std::string &	ConversationID.
conversationType	ZIMConversationType	Conversation Type.
errorMessageIDs	std::vector<long long>	Set the message ID corresponding to the message receipt failure.
errorInfo	ZIMError	Set the error code of the receipt message read. 0 indicates that the setting is successful, and non-zero indicates that the setting fails. If the setting fails, the developer should check the official website error code document for solutions.

Details

Set the callback interface for the read receipt message.

Use cases: Developers can judge whether the setting is successful through [errorCode] in the callback.

Notification timing: When the developer calls the [sendMessageReceiptsRead] interface, this callback will be triggered.

Related APIs: The success or failure of the message read result set by [sendMessageReceiptsRead] will be notified through this callback.

Available since: 2.5.0 and above.

ZIMMessageReceiptsInfoQueriedCallback

public ZIMMessageReceiptsInfoQueriedCallback

Callback interface for query receipt message read.

Parameters

Name	Type	Description
infos	std::vector<ZIMMessageReceiptInfo> &	Query receipt information.
errorMessageIDs	std::vector<long long>	Query the wrong message ID of the message receipt information.
errorInfo	ZIMError	Query the error code of the message receipt. 0 means the query is successful, and non-zero means the query failed. If the query fails, the developer should check the official website error code document for solutions.

Details

Callback interface for querying receipt message information.

Use cases: Developers can judge whether the sending is successful through [errorCode] in the callback.

Notification timing: When the developer calls the [queryMessageReceiptsInfo] interface, this callback will be triggered.

Related APIs: through [queryMessageReceiptsInfo], whether the result of querying the receipt information is successful or not will be notified through this callback.

Available since: 2.5.0 and above.

ZIMGroupMessageReceiptMemberListQueriedCallback

public ZIMGroupMessageReceiptMemberListQueriedCallback

Callback interface for querying the specific read/unread member list of group receipt messages.

Parameters

Name	Type	Description
groupID	std::string	Group ID.
userList	std::vector<ZIMGroupMemberInfo>	Query the list of successful group users.
nextFlag	unsigned int	Query the flag corresponding to the next page, which is used for the next flag parameter of [ZIMGroupMessageReceiptMemberQueryConfig].
errorInfo	ZIMError	Set the error code returned by querying the group member list. 0 means the query is successful, and non-zero means the query failed. If the query fails, the developer should check the official website error code document for solutions.

Details

The callback interface for querying the specific read/unread member list of the group receipt message.

Use cases: Developers can judge whether the sending is successful through [errorCode] in the callback.

Notification timing: When the developer calls the [queryGroupMessageReceiptReadMemberList] / [queryGroupMessageReceiptUnreadMemberList] interface, this callback will be triggered.

Available since: 2.5.0 and above.

ZIMMessageRevokedCallback

public ZIMMessageRevokedCallback

Retracted news consequential reconciliation.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	Message object.
errorInfo	ZIMError	Retraction notice. 0 representative withdraw successfully, non 0 withdraw unsuccessful. When the withdrawal fails, the developer responds to the official website Review the solution.

Use cases: Developer allowed through this process during response [errorCode] Successful delivery.
Trigger: For our developers [revokeMessage] When contacting, this revoke will be sent.
Related APIs: If the revoked message is the latest message of the session, the [conversationChanged] callback will be triggered, and if the message is unread, the [conversationTotalUnreadMessageCountUpdated] callback will be triggered.

ZIMMessageQueriedCallback

public ZIMMessageQueriedCallback

The developer uses this callback to get a list of queried messages, which can be used to display historical messages.

Parameters

Name	Type	Description
conversationID	const std::string &	ConversationID.
conversationType	ZIMConversationType	Conversation Type.
messageList	const std::vector<std::shared_ptr<ZIMMessage>> &	The message list of the query result.
errorInfo	ZIMError	The error code of the query message. 0 means the query message is successful, non-0 means the query message fails. If the query message fails, the developer should check the official website error code document to query the solution.

Details

Callback result of query message list.

Use cases: Through this callback, developers can obtain the list of queried messages and display historical messages.

Notification timing: After calling queryHistoryMessage, the list of queried messages is notified through this callback.

Related APIs: Use [queryPeerMessage] to query historical messages. The queried message list is notified through this callback.

Available since: 2.0.0 or later.

ZIMPinnedMessageListQueriedCallback

public ZIMPinnedMessageListQueriedCallback

The developer uses this callback to get a list of queried pinned messages, which can be used to display pinned messages.

Parameters

Name	Type	Description
messageList	const std::vector<std::shared_ptr<ZIMMessage>> &messageList	The message list of the query result.
errorInfo	ZIMError	The error code of the query message. 0 means the query message is successful, non-0 means the query message fails. If the query message fails, the developer should check the official website error code document to query the solution.

Related APIs: The [queryPinnedMessageList] interface is used to query the list of pinned messages. The queried message list is notified through this callback.

ZIMConversationMessagesAllDeletedCallback

public ZIMConversationMessagesAllDeletedCallback

Deletes callbacks of all messages for all sessions.

Parameters

Name	Type	Description
errorInfo	ZIMError	Delete the error code of the message. 0 means the deletion of the message succeeded, non-0 means the deletion of the message failed. If the deletion message fails, the developer should check the official website error code document to query the solution.

Details

Supported versions: 2.14.0 and above.

Detail description: After all messages of all sessions are deleted, the callback returns the message deletion result.

Business scenario: The developer can judge whether the deletion is successful through the [errorCode] in the callback.

Notification timing: Triggered after calling the delete message interface [deleteAllConversationMessages].

Related interface: [deleteAllConversationMessages].

ZIMMessageDeletedCallback

public ZIMMessageDeletedCallback

A callback to delete a message.

Parameters

Name	Type	Description
conversationID	const std::string &	Conversation ID
conversationType	ZIMConversationType	Conversation Type
errorInfo	ZIMError	Delete the error code of the message. 0 means the deletion of the message succeeded, non-0 means the deletion of the message failed. If the deletion message fails, the developer should check the official website error code document to query the solution.

Details

Supported versions: 2.0.0 and above.

Detail description: After the message is deleted, the result of message deletion is returned through this callback.

Business scenario: The developer can judge whether the deletion is successful through the [errorCode] in the callback.

Notification timing: Triggered after calling the delete message interface [deleteMessage].

Related interface: [deleteMessage].

ZIMMediaDownloadedCallback

public ZIMMediaDownloadedCallback

The result callback of the download completion of the media message.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	The sent message object, from which parameters such as messageID can be obtained. If the sending fails, the messageID parameter in the message will be an empty string.
errorInfo	ZIMError	The error code of the sent message. 0 means sending the message successfully, non-0 means sending the message failed. If there is a failure to send a message, the developer should check the official website error code document to query the solution.

Related APIs: Download media messages through [downloadMediaFile], and it will be notified through this callback whether it is successful or not.

ZIMMediaUploadingProgress

public ZIMMediaUploadingProgress

Progress callback for sending media messages.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMediaMessage> &	The message object for the current file upload.
currentFileSize	unsigned long long	The current progress, that is, the real-time size of the current file upload.
totalFileSize	unsigned long long	Total progress, which is the total size of the current file.

Details

Supported versions: 2.1.0 and above.

Detail description: The progress callback for sending media messages.

Business scenario: The developer can obtain the sending progress of the media message through this callback.

Notification timing: When the developer calls the [sendMediaMessage] interface, the callback will be triggered, and will be triggered multiple times during the sending process.

Related interface: Through [sendMediaMessage], the sending progress will be notified through this callback.

ZIMMessageExportingProgress

public ZIMMessageExportingProgress

Progress callback of the exported message.

Parameters

Name	Type	Description
exportedMessageCount	unsigned long long	Current progress, that is, the number of exported messages.
totalMessageCount	unsigned long long	Total progress: The total number of exported messages.

Related APIs: With [exportLocalMessages], the exported progress is notified by this callback.

ZIMMessageImportingProgress

public ZIMMessageImportingProgress

Progress callback of the imported message.

Parameters

Name	Type	Description
importedMessageCount	unsigned long long	Current progress, that is, the number of imported messages.
totalMessageCount	unsigned long long	Total progress: The total number of imported messages.

Related APIs: With [importLocalMessages], the imported progress is notified by this callback.

ZIMMediaDownloadingProgress

public ZIMMediaDownloadingProgress

Progress callback for downloading media file messages.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage> &	The message object for the current file download.
currentFileSize	unsigned long long	The current progress, that is, the real-time size of the current file download.
totalFileSize	unsigned long long	Total progress, which is the total size of the current file.

Related APIs: Through [downloadMediaFile], the download progress will be notified through this callback.

ZIMMessageLocalExtendedDataUpdatedCallback

public ZIMMessageLocalExtendedDataUpdatedCallback

Callback for updating message local extension fields.

Parameters

Name	Type	Description
message	const std::shared_ptr<ZIMMessage>	Updated of the message.
errorInfo	const ZIMError &	Error code.

Use cases: Developers can determine whether the operation is successful through the [errorCode] in this callback.

Notification timing: This callback is triggered when developers call the [updateMessageLocalExtendedData] interface.

ZIMMessagesSearchedCallback

public ZIMMessagesSearchedCallback

Return of local message search results.

Parameters

Name	Type	Description
conversationID	const std::string &	Conversation ID, in the case of one-on-one chat, the conversationID is the userID of the other party. In the case of a group chat, the conversationID is the groupID of the group.
conversationType	ZIMConversationType	Conversation types. 0: One-on-one chat, 1: Room, 2: Group. Note: In the "Room" scenario, caching and searching for offline messages are not supported by default.
messageList	const std::vector<ZIMMessage> &	List of searched messages.
nextMessage	const std::vector<std::shared_ptr<ZIMMessage>> &	Pagination retrieval flag, message anchor for searching the next page.
errorInfo	const ZIMError &	Search local message error codes. 0 represents a successful search for local messages, and non-zero values indicate a failure to search for local messages. If a failure to search for local messages occurs, developers should refer to the official website's error code documentation for solutions.

Details

Detailed description: Return of search results for local messages.

Use cases: After performing a local message search operation, the success or failure can be determined through this callback.

Related API: [searchLocalMessages], search for local messages.

ZIMMessagesGlobalSearchedCallback

public ZIMMessagesGlobalSearchedCallback

Return of local message search results.

Parameters

Name	Type	Description
messageList	const std::vector<std::shared_ptr<ZIMMessage>> &	List of searched messages.
nextMessage	const std::shared_ptr<ZIMMessage> &	Pagination retrieval flag, message anchor for searching the next page.
errorInfo	const ZIMError &	Error codes for global search of local messages. 0 represents a successful global search of local messages, while non-zero indicates a failed global search of local messages. If a failure occurs during the global search of local messages, developers should refer to the official error code documentation for solutions.

Details

Detailed description: Return of search results for local messages.

Use cases: After performing a local message search operation, the success or failure can be determined through this callback.

Related API: [searchLocalMessages], search for local messages.

ZIMConversationsSearchedCallback

public ZIMConversationsSearchedCallback

Search for the return of local conversations results based on local messages.

Parameters

Name	Type	Description
conversationSearchInfoList	const std::vector<ZIMConversationSearchInfo>&	List of searched conversation messages.
nextFlag	unsigned int	Pagination retrieval flag, anchor for searching the next page.
errorInfo	const ZIMError &	The error code of the search result. 0 means the search is successful, non-zero means the search failed. If the search fails, the developer should check the error code documentation on the official website for solutions.

Details

Search the results of local conversations based on local messages.

Use cases: After performing a local session message search operation, the success or failure can be known through this callback.

Related API: [searchLocalConversations], search for local conversations based on local messages.

ZIMRoomMembersQueriedCallback

public ZIMRoomMembersQueriedCallback

Callback for the result of querying the specified member of the room.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID.
memberList	const std::vector<ZIMRoomMemberInfo> &	List of user information.
errorUserList	const std::vector<ZIMErrorUserInfo> &	List of users whose query failed.
errorInfo	ZIMError	error info.

Details

After querying room user information, the query result is returned through this callback.

Use cases: The logic after querying room user information can be done in this callback.
When to call /Trigger: Triggered after querying room user information.

Available since: 2.8.0 and above.

ZIMRoomMembersAttributesQueriedCallback

public ZIMRoomMembersAttributesQueriedCallback

Returns the results of batch query of room user attributes.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID.
infos	const std::vector<ZIMRoomMemberAttributesInfo> &	List of room user attributes.
errorInfo	ZIMError	Error code for querying room user attributes. 0 means the query of room user attributes is successful, non-0 means the query of room user attributes fails. If there is a failure to query the room user attributes, the developer should check the https://doc-zh.zego.im/article/11606 query solution.

Details

Supported version: 2.4.0 and later.

Detailed description: According to the UserID list, batch query results of room user attributes are returned.

Business scenario: After querying room user attributes, the success or failure and query results can be known through this callback.

Notification timing: The result will be returned after the room user attribute query is completed.

Related interface: [queryRoomMembersAttributes], query room user attributes.

ZIMRoomMemberAttributesListQueriedCallback

public ZIMRoomMemberAttributesListQueriedCallback

Returns the query result of the user attribute list in the room.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID.
infos	const std::vector<ZIMRoomMemberAttributesInfo> &	List of room user attributes.
nextFlag	const std::string &	The anchor of the next paging query. If it is empty, it means that the query has been completed.
errorInfo	ZIMError	Error code for querying room user attributes. 0 means the query of room user attributes is successful, non-0 means the query of room user attributes fails. If there is a failure to query the room user attributes, the developer should check the https://doc-zh.zego.im/article/11606 query solution.

Details

Supported version: 2.4.0 and later.

Detail description: Returns the result of paging query of all user attribute lists in the room.

Business scenario: After querying room user attributes, the success or failure and query results can be known through this callback.

Notification timing: The result will be returned after the room user attribute query is completed.

Related interface: [queryRoomMemberAttributesList], query room user attributes.

ZIMRoomCreatedCallback

public ZIMRoomCreatedCallback

Callback of the result of creating the room.

Parameters

Name	Type	Description
roomInfo	const ZIMRoomFullInfo &	Details of the room created. If the creation fails, the roomID parameter in roomInfo will be an empty string.
errorInfo	ZIMError	Error information.

Details

The callback of the result of creating the room.

Related APIs: Create a room through [createRoom], and the result of the creation will be notified through this callback.

Available since: 1.1.0 or above.

ZIMRoomEnteredCallback

public ZIMRoomEnteredCallback

Callback of the result of entering the room.

Parameters

Name	Type	Description
roomInfo	const ZIMRoomFullInfo &	Details of the room created. If the creation fails, the roomID parameter in roomInfo will be an empty string.
errorInfo	ZIMError	Error information.

Related APIs: Create a room through [enterRoom], and the entry result will be notified through this callback.

ZIMRoomSwitchedCallback

public ZIMRoomSwitchedCallback

Callback of the result of switched rooms.

Parameters

Name	Type	Description
roomInfo	const ZIMRoomFullInfo &	Full info of the room switched.
errorInfo	ZIMError	Error information.

Related APIs: Switched rooms through [switchRoom], and the result will be notified through this callback.

ZIMRoomJoinedCallback

public ZIMRoomJoinedCallback

Callback of the result of joining the room.

Parameters

Name	Type	Description
roomInfo	const ZIMRoomFullInfo &	Details of the room joined. If the join fails, the roomID parameter in roomInfo will be an empty string.
errorInfo	ZIMError	Error code to join room. 0 means join the room successfully, non-0 means join the room failed. If there is a failure to join the room, the developer should check the official website error code document to query the solution.

Details

The callback of the result of joining the room.

Related APIs: Join the room through [joinRoom], and the result of joining will be notified through this callback.

Available since: 1.1.0 or above.

ZIMRoomAllLeftCallback

public ZIMRoomAllLeftCallback

Callback for the results of leaving all rooms.

Parameters

Name	Type	Description
roomIDs	std::vector<std::string>	Room IDs.

Trigger: When the user calls [leaveAllRoom], the callback will be triggered to return the result.

Available since: 1.15 or above.

ZIMRoomLeftCallback

public ZIMRoomLeftCallback

Callback of the result of leaving the room.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID
errorInfo	ZIMError	Error code to leave the room. 0 means leaving the room successfully, non-0 means leaving the room failed. If there is a failure to leave the room, the developer should check the official website error code document to query the solution.

Details

The callback of the result of leaving the room.

Related APIs: Leave the room through [leaveRoom], and the result of leaving will be notified through this callback.

Available since: 1.1.0 or above.

ZIMRoomMemberQueriedCallback

public ZIMRoomMemberQueriedCallback

Callback of the result of querying the room members list.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID
memberList	const std::vector<ZIMUserInfo> &	List of members in the room.
nextFlag	const std::string &	The flag of the paging query. If this field is an empty string, the query has been completed. Otherwise, you need to set this value to the "nextFlag" field of ZIMQueryMemberConfig for the next page query.
errorInfo	ZIMError	Query the error code of room members. 0 means querying room members successfully, non-0 means querying room members failed. If there is a failure to query room members, the developer should check the official website for the error code document query solution.

Details

Callback for the result of querying the room member list.

Related APIs: Query the list of room members through [queryRoomMember], and the query result will be notified through this callback.

Available since: 1.1.0 or above.

ZIMRoomOnlineMemberCountQueriedCallback

public ZIMRoomOnlineMemberCountQueriedCallback

Callback of the result of querying the online members count in the room.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID
count	unsigned int	The number of online members of the room.
errorInfo	ZIMError	Query the error code of the online member of the room. 0 means the query of online members of the room is successful, and non-0 means the query of online members of the room fails. If there is a failure to query the online members of the room, the developer should check the official website for the error code document query solution.

Details

Callback of the result of querying the online members count in the room.

Related APIs: You can check the online number of people in the room through [queryRoomOnlineMemberCount].

Available since: 1.1.0 or above.

ZIMRoomAttributesQueriedCallback

public ZIMRoomAttributesQueriedCallback

Return of room attribute query results.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID
roomAttributes	std::unordered_map<std::string, std::string> &	Room attributes in the room.
errorInfo	ZIMError	Error code for querying all properties of the room. 0 means that the query of all properties of the room is successful, and non-0 means that the query of all the properties of the room fails. If the query of all the properties of the room fails, the developer should check the official website for the error code document query solution.

Details

Return of room attribute query results.

Available since: 1.3.0.

ZIMRoomAttributesOperatedCallback

public ZIMRoomAttributesOperatedCallback

The return of the operation result of the room attribute.

Parameters

Name	Type	Description
roomID	std::string	Room ID.
errorKeys	const std::vector<std::string> &	Keys for failed operation.
errorInfo	ZIMError	Error code for room attribute operation. 0 means the room property operation is successful, non-0 means the room property operation fails. If the room attribute operation fails, the developer should check the official website error code document to query the solution.

Details

The return of the operation result of the room attribute.

Available since: 1.3.0.

ZIMRoomAttributesBatchOperatedCallback

public ZIMRoomAttributesBatchOperatedCallback

The return of the result of the room attribute combination operation.

Parameters

Name	Type	Description
roomID	const std::string &	Room ID
errorInfo	ZIMError	Error code for room property batch operations. 0 means the room attribute batch operation is successful, non-0 means the room attribute batch operation fails. If the room attribute batch operation fails, the developer should check the official website error code document to query the solution.

Details

The return of the result of the room attribute combination operation.

Available since: 1.3.0.

errorInfo

Methods

ZIMConversationNotificationStatusSetCallback

public ZIMConversationNotificationStatusSetCallback

Callback for conversation notification state settings.

Parameters

Name	Type	Description
conversationType	ZIMConversationType	Conversation type.
errorInfo	ZIMError	Set the error code for the callback notification state. 0 means setting the call back notification state successfully, non-0 means setting the call back notification state fails. If there is a failure to set the callback notification status, the developer should check the official website error code document to query the solution.

Details

This callback returns the result of group notification after the group notification status is set.

Use cases: You can do the logic after setting the group notification status in this callback.
When to call /Trigger: Triggered when the group notification status is set.
Related APIs: [setConversationNotificationStatus].

Available since: 2.0.0 and above.