> ## 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\*\*](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent)

傳回指向自上次呼叫 XblSocialManagerDoWork 以來所發生之社交事件陣列的指標。此陣列只在下次呼叫 XblSocialManagerDoWork 之前有效。呼叫 XblCleanup 時，會自動清除內部陣列。

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

傳回社交事件陣列中的事件數目。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

必須每個畫面格都呼叫，資料才會保持最新。傳回的社交事件陣列只在下次呼叫 [XblSocialManagerDoWork](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 之前有效。請務必檢查是否有傳回社交事件。如果社交事件陣列為 null，表示沒有結果。如果社交事件計數為 0，表示沒有結果。如果有傳回社交事件，請依據各自的 [XblSocialManagerEventType](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype) 處理每個 [XblSocialManagerEvent](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent)。

## 需求

**標頭：** social\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

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