> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserAddByIdWithUiResult

> XUserAddByIdWithUiResult

# XUserAddByIdWithUiResult

擷取 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) 所建立之使用者的控制代碼。
此函式只應用於回應遊戲邀請。

## 語法

```cpp theme={null}
HRESULT XUserAddByIdWithUiResult(  
         XAsyncBlock* async,  
         XUserHandle* newUser  
)  
```

### 參數

*async*   \_Inout\_\
類型：[XAsyncBlock\*](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md)

先前傳送給 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) 的 [XAsyncBlock](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md)。

*newUser*   \_Out\_\
類型：XUserHandle\*

包含新使用者的控制代碼。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。
如需錯誤碼清單，請參閱[錯誤碼](https://docs.xbox.com/zh-TW/reference/errorcodes.md)。

| 傳回碼 | 描述 |
| - | - |
| S\_OK | 作業成功。 |
| E\_GAMEUSER\_USER\_NOTFOUND | 傳入 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) 之 XUID 所指定的使用者已不再登入裝置。 |

## 備註

如需如何使用此函式的詳細資訊，請參閱 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddbyidwithuiasync.md)。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XUser](https://docs.xbox.com/zh-TW/reference/system/xuser/xuser_members.md)\
[XUserCloseHandle](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserclosehandle.md)


## Related topics

- [XUserAddByIdWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddbyidwithuiasync.md)
- [XUser (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xuser/xuser_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [PFGameSaveFilesAddUserWithUiResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [XUserAddResult](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddresult.md)