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

# XUserDuplicateHandle

> XUserDuplicateHandle

# XUserDuplicateHandle

复制用户句柄。

## 语法

```cpp theme={null}
HRESULT XUserDuplicateHandle(  
         XUserHandle handle,  
         XUserHandle* duplicatedHandle  
)  
```

### 参数

*handle*   \_In\_\
类型：XUserHandle

要复制的用户句柄。

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

包含复制后的用户句柄。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。\
有关错误代码列表，请参阅[错误代码](/reference/errorcodes)。

## 注解

**XUserHandle** 表示一个 XBOX 游戏用户。
若要查看两个不同的 XUserHandle 是否指向同一个用户，请调用 [XUserCompare](/reference/system/xuser/functions/xusercompare) 函数。

若要关闭用户句柄，请调用 [XUserCloseHandle](/reference/system/xuser/functions/xuserclosehandle)。

## 要求

**头文件：** XUser.h

**库：** xgameruntime.lib

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

## 另请参阅

[XUser](/reference/system/xuser/xuser_members)

[XUserCompare](/reference/system/xuser/functions/xusercompare)

[XUserCloseHandle](/reference/system/xuser/functions/xuserclosehandle)


## Related topics

- [XUser](/zh-CN/reference/system/xuser/xuser_members.md)
- [PFEntityDuplicateHandle](/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityduplicatehandle.md)
- [WdDuplicateCancellationHandle](/zh-CN/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [XTaskQueueDuplicateHandle](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueduplicatehandle.md)
- [XblContextDuplicateHandle](/zh-CN/reference/live/xsapi-c/xbox_live_context_c/functions/xblcontextduplicatehandle.md)