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

# XUserGetTokenAndSignatureUtf16Async

> XUserGetTokenAndSignatureUtf16Async

# XUserGetTokenAndSignatureUtf16Async

以非同步方式擷取授權對目標 URL 進行 HTTPS 呼叫所需之 X 權杖和簽章的 API。如果在遊戲的 [Partner Center 單一登入頁面](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on)中有與目標 URL 關聯的信賴憑證者，此 API 會傳回 X 權杖和簽章。在提出要求之前，請將 [API 的 Result 版本](/zh-TW/reference/system/xuser/functions/xusergettokenandsignatureutf16result)所提供的 X 權杖和簽章值新增至 HTTPS 呼叫的 Authorization 和 Signature 標頭。

## 語法

```cpp theme={null}
HRESULT XUserGetTokenAndSignatureUtf16Async(  
         XUserHandle user,  
         XUserGetTokenAndSignatureOptions options,  
         const wchar_t* method,  
         const wchar_t* url,  
         size_t headerCount,  
         const XUserGetTokenAndSignatureUtf16HttpHeader* headers,  
         size_t bodySize,  
         const void* bodyBuffer,  
         XAsyncBlock* async  
)  
```

### 參數

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

Web 要求所屬使用者的控制代碼。

*options*   \_In\_\
類型：[XUserGetTokenAndSignatureOptions](/zh-TW/reference/system/xuser/enums/xusergettokenandsignatureoptions)

擷取使用者權杖和簽章的選項。

*method*   \_In\_z\_\
類型：wchar\_t\*

Web 要求的方法類型 (Unicode)。

*url*   \_In\_z\_\
類型：wchar\_t\*

HTTPS 要求的目標 URL。請為 HTTPS 要求使用完整的 URL 字串。請勿縮寫 URL。

*headerCount*   \_In\_\
類型：size\_t

*headers* 參數中的標頭數目。

*headers*   \_In\_reads\_opt\_(headerCount)\
類型：[XUserGetTokenAndSignatureUtf16HttpHeader\*](/zh-TW/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader)

Web 要求的標頭。

*bodySize*   \_In\_\
類型：size\_t

*bodyBuffer* 參數中緩衝區的大小。

*bodyBuffer*   \_In\_reads\_bytes\_opt\_(bodySize)\
類型：void\*

包含 Web 要求本文的緩衝區。

*async*   \_Inout\_\
類型：XAsyncBlock\*

用於輪詢呼叫狀態並擷取呼叫結果的 [XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock)。

### 傳回值

類型：HRESULT

如果成功，則傳回 S\_OK；否則傳回錯誤碼。
如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

## 備註

XUserGetTokenAndSignatureUtf16Async 函式使用 [XUserGetTokenAndSignatureOptions](/zh-TW/reference/system/xuser/enums/xusergettokenandsignatureoptions) 列舉引數，以非同步方式擷取 Web 要求的 Unicode X 權杖和簽章。

若要擷取呼叫 XUserGetTokenAndSignatureUtf16Async 的結果，請呼叫 [XUserGetTokenAndSignatureUtf16Result](/zh-TW/reference/system/xuser/functions/xusergettokenandsignatureutf16result)。

若要擷取保存呼叫 XUserGetTokenAndSignatureUtf16Async 之結果所需的緩衝區大小，請呼叫 [XUserGetTokenAndSignatureUtf16ResultSize](/zh-TW/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize)。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [WinHTTP 概觀](/zh-TW/build/console-features/networking/web-requests/intro-winhttp)
* [實作玩家登入](/zh-TW/services/xbox-services/playfab-integration)

## 另請參閱

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

[XUserGetTokenAndSignatureUtf16Result](/zh-TW/reference/system/xuser/functions/xusergettokenandsignatureutf16result)

[XUserGetTokenAndSignatureUtf16ResultSize](/zh-TW/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize)


## Related topics

- [XUserGetTokenAndSignatureUtf16Async](/reference/system/xuser/functions/xusergettokenandsignatureutf16async.md)
- [XUserGetTokenAndSignatureUtf16Result](/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)
- [XUserGetTokenAndSignatureUtf16ResultSize](/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md)
- [XUserGetTokenAndSignatureUtf16Data](/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md)