> ## 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](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagerextradetaillevel)

此使用者的服務呼叫中應包含的詳細程度。

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

要用於此使用者背景作業的佇列 (選擇性)。注意：對此佇列使用 XTaskQueueDispatchMode::Immediate 可能會導致效能不佳。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

新增本機使用者的結果會透過 [XblSocialManagerDoWork](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 中的 [XblSocialManagerEventType](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::LocalUserAdded 事件觸發。若要移除指定本機使用者的社交圖表，請呼叫 [XblSocialManagerRemoveLocalUser](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerremovelocaluser)。

## 需求

**標頭：** 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

- [XblSocialManagerGetLocalUserCount](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusercount.md)
- [XblSocialManagerExtraDetailLevel](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagerextradetaillevel.md)
- [XblSocialManagerRemoveLocalUser](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerremovelocaluser.md)
- [XblSocialManagerGetLocalUsers](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusers.md)
- [XblPresenceFilter](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblpresencefilter.md)