> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent.md)

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

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

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

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

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

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

## 另请参阅

[social\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)


## Related topics

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