> ## 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-CN/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) 创建的用户的句柄。此函数只应在响应游戏邀请时使用。

## Syntax

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

### Parameters

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

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

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

包含新用户的句柄。

### Return value

类型：HRESULT

HRESULT 成功或错误代码。
有关错误代码列表，请参阅[错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)。

| 返回代码 | 说明 |
| - | - |
| S\_OK | 操作成功。 |
| E\_GAMEUSER\_USER\_NOTFOUND | 传递到 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) 的 XUID 中指定的用户不再登录到设备。 |

## Remarks

有关如何使用此函数的更多详细信息，请参阅 [XUserAddByIdWithUiAysnc](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddbyidwithuiasync.md)。

## Requirements

**头文件：** XUser.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

## See also

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


## Related topics

- [XUserAddByIdWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddbyidwithuiasync.md)
- [XUser（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xuser/xuser_members.md)
- [在 Unity 项目中使用 GDK API 的 C# 包装器](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [PFGameSaveFilesAddUserWithUiResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [XUserAddResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddresult.md)