XblSocialManagerDoWork

Called whenever the title wants to update the social graph and get list of change events.

Syntax

HRESULT XblSocialManagerDoWork(  
         const XblSocialManagerEvent** socialEvents,  
         size_t* socialEventsCount  
)  

Parameters

socialEvents _Outptr_result_maybenull_
Type: XblSocialManagerEvent** Passes back a pointer to the array of social events that have occurred since the last call to XblSocialManagerDoWork. This array is only valid until the next call to XblSocialManagerDoWork. The internal array will automatically be cleaned up when XblCleanupAsync is called. socialEventsCount _Out_
Type: size_t* Passes back the number of events in the social events array.

Return value

Type: HRESULT Returns S_OK if successful, including when there are no events. When there are no events, socialEvents is set to null and socialEventsCount is set to 0. Possible error codes include the following. This list isn’t exhaustive.

Return code	Description
E_INVALIDARG	`socialEvents` or `socialEventsCount` is null. The arguments are validated before the initialization check.
E_XBL_NOT_INITIALIZED	The XBOX services API isn’t initialized.

Remarks

Must be called every frame for data to be up to date. The array of social events that is sent back is only valid until the next call to XblSocialManagerDoWork. Make sure to check if there were social events sent back. If the social events array is null, no results. If the social events count is 0, no results. If there were social events sent back then handle each XblSocialManagerEvent by their respective XblSocialManagerEventType.

Requirements

Header: social_manager_c.h Library: Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntax

Parameters

Return value

Remarks

Requirements

See also

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

Syntax

Parameters

Return value

Remarks

Requirements

See also