XblSocialManagerAddLocalUser

Create a social graph for the specified local user.

Syntax

HRESULT XblSocialManagerAddLocalUser(  
         XblUserHandle user,  
         XblSocialManagerExtraDetailLevel extraLevelDetail,  
         XTaskQueueHandle queue  
)  

Parameters

user   _In_
Type: XblUserHandle XBOX user to create a graph for. extraLevelDetail   _In_
Type: XblSocialManagerExtraDetailLevel The level of verbosity that should be in the service calls for this user. queue   _In_opt_
Type: XTaskQueueHandle Queue to be used for background operation for this user (Optional). Note: Using XTaskQueueDispatchMode::Immediate for this queue may cause poor performance.

Return value

Type: HRESULT Returns S_OK if the request to add the user was accepted. S_OK doesn’t mean that the social graph is ready; wait for the LocalUserAdded event from XblSocialManagerDoWork. Possible error codes include the following. This list isn’t exhaustive.

Return code	Description
E_XBL_NOT_INITIALIZED	The XBOX services API isn’t initialized.
E_INVALIDARG	`user` is null.
E_UNEXPECTED	A user with the same XBOX user ID (XUID) was already added to Social Manager.

Remarks

The result of a local user being added will be triggered through the XblSocialManagerEventType::LocalUserAdded event in XblSocialManagerDoWork. To remove the social graph for the specified local user, call XblSocialManagerRemoveLocalUser.

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