> ## 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 成功或錯誤碼。\
如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

## 備註

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

若要關閉使用者控制代碼，請呼叫 [XUserCloseHandle](/zh-TW/reference/system/xuser/functions/xuserclosehandle)。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XUser](/zh-TW/reference/system/xuser/xuser_members)

[XUserCompare](/zh-TW/reference/system/xuser/functions/xusercompare)

[XUserCloseHandle](/zh-TW/reference/system/xuser/functions/xuserclosehandle)


## Related topics

- [XUser](/zh-TW/reference/system/xuser/xuser_members.md)
- [PFEntityDuplicateHandle](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityduplicatehandle.md)
- [WdDuplicateCancellationHandle](/zh-TW/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [XTaskQueueDuplicateHandle](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueduplicatehandle.md)
- [HCMockCallDuplicateHandle](/zh-TW/reference/live/httpclient/mock/functions/hcmockcallduplicatehandle.md)