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

# XUserDuplicateHandle

> XUserDuplicateHandle

# XUserDuplicateHandle

複製使用者控制代碼。

## 語法

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

### 參數

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

要複製的使用者控制代碼。

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

包含複製的使用者控制代碼。

### 傳回值

類型：HRESULT

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

## 備註

**XUserHandle** 代表 XBox 遊戲使用者。
若要查看兩個不同的 XUserHandle 是否指向同一個使用者，請呼叫 [XUserCompare](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xusercompare.md) 函式。

若要關閉使用者控制代碼，請呼叫 [XUserCloseHandle](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserclosehandle.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)

[XUserCompare](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xusercompare.md)

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


## Related topics

- [PFEntityDuplicateHandle](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityduplicatehandle.md)
- [XTaskQueueDuplicateHandle](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueduplicatehandle.md)
- [WdDuplicateCancellationHandle](https://docs.xbox.com/zh-TW/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [XblContextDuplicateHandle](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/xbox_live_context_c/functions/xblcontextduplicatehandle.md)
- [HCMockCallDuplicateHandle](https://docs.xbox.com/zh-TW/reference/live/httpclient/mock/functions/hcmockcallduplicatehandle.md)