> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblSocialManagerDoWork

> XblSocialManagerDoWork

# XblSocialManagerDoWork

每当游戏想要更新社交图并获取更改事件列表时调用。

## 语法

```cpp theme={null}
HRESULT XblSocialManagerDoWork(  
         const XblSocialManagerEvent** socialEvents,  
         size_t* socialEventsCount  
)  
```

### 参数

*socialEvents*   \_Outptr\_result\_maybenull\_\
类型：[XblSocialManagerEvent\*\*](/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent)

传回一个指向自上次调用 XblSocialManagerDoWork 以来发生的社交事件数组的指针。此数组仅在下一次调用 XblSocialManagerDoWork 之前有效。调用 XblCleanup 时，将自动清理内部数组。

*socialEventsCount*   \_Out\_\
类型：size\_t\*

传回社交事件数组中的事件数。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

必须每一帧都调用一次此函数以确保数据为最新。发送回的社交事件数组仅在下一次调用 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 之前有效。请务必检查是否有社交事件被返回。如果社交事件数组为 null，则表示无结果。如果社交事件计数为 0，则表示无结果。如果返回了社交事件，请根据每个 [XblSocialManagerEvent](/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent) 的相应 [XblSocialManagerEventType](/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype) 进行处理。

## 要求

**标头：** social\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[social\_manager\_c](/reference/live/xsapi-c/social_manager_c/social_manager_c_members)


## Related topics

- [XblSocialManagerEvent](/zh-CN/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent.md)
- [XblSocialManagerUserGroupGetUsers](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)
- [XblSocialManagerUpdateSocialUserGroup](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerupdatesocialusergroup.md)
- [XblSocialManagerCreateSocialUserGroupFromFilters](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters.md)
- [XblSocialManagerCreateSocialUserGroupFromList](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md)