> ## 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.

# XblSocialManagerAddLocalUser

> XblSocialManagerAddLocalUser

# XblSocialManagerAddLocalUser

为指定的本地用户创建社交图。

## 语法

```cpp theme={null}
HRESULT XblSocialManagerAddLocalUser(  
         XblUserHandle user,  
         XblSocialManagerExtraDetailLevel extraLevelDetail,  
         XTaskQueueHandle queue  
)  
```

### 参数

*user*   \_In\_\
类型：XblUserHandle

要为其创建图的 XBOX Live 用户。

*extraLevelDetail*   \_In\_\
类型：[XblSocialManagerExtraDetailLevel](/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagerextradetaillevel)

此用户的服务调用应达到的详细程度。

*queue*   \_In\_opt\_\
类型：XTaskQueueHandle

用于此用户的后台操作的队列（可选）。注意：对此队列使用 XTaskQueueDispatchMode::Immediate 可能会导致性能不佳。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

添加本地用户的结果将通过 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 中的 [XblSocialManagerEventType](/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::LocalUserAdded 事件触发。若要移除指定本地用户的社交图，请调用 [XblSocialManagerRemoveLocalUser](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerremovelocaluser)。

## 要求

**标头：** 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

- [XblSocialManagerGetLocalUserCount](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusercount.md)
- [XblSocialManagerRemoveLocalUser](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerremovelocaluser.md)
- [XblSocialManagerExtraDetailLevel](/zh-CN/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagerextradetaillevel.md)
- [XblSocialManagerGetLocalUsers](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusers.md)
- [Social Manager 概述](/zh-CN/services/xbox-services/community/social-manager/live-social-manager-overview.md)