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

# XblFormatSecureDeviceAddress

> XblFormatSecureDeviceAddress

# XblFormatSecureDeviceAddress

針對不支援 SDA 的平台，根據指定的唯一裝置識別碼格式化安全裝置位址。

## 語法

```cpp theme={null}
HRESULT XblFormatSecureDeviceAddress(  
         const char* deviceId,  
         XblFormattedSecureDeviceAddress* address  
)  
```

### 參數

*deviceId*   \_In\_\
類型：char\*

在本機遊戲處理程序/執行個體的存留期間代表此裝置的唯一識別碼。

*address*   \_Inout\_\
類型：[XblFormattedSecureDeviceAddress\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblformattedsecuredeviceaddress)

傳回格式化的安全裝置位址。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

依照下列建議格式化 deviceId 字串：產生 16 個隨機位元組 (例如 GUID)，在本機遊戲處理程序/執行個體的存留期間用來唯一代表該裝置。將 'secureDeviceAddress' 格式化為字串，以前置詞 "AAAAAAAA" (8 個大寫字母 A) 開頭，後面接著隨機位元組的 32 字元十六進位表示法 (字母大小寫無關緊要；如果位元組是實際的結構化 GUID，位元組順序也無關緊要)。例如 "AAAAAAAA00112233445566778899AABBCCDDEEFF"。使用格式化的 SDA 呼叫 XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64，以設定使用者的 SDA。

## 需求

**標頭：** multiplayer\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[multiplayer\_c](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetsecuredeviceaddressbase64.md)
- [XblFormattedSecureDeviceAddress](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblformattedsecuredeviceaddress.md)
- [XblMultiplayerConnectionAddressDeviceTokenPair](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerconnectionaddressdevicetokenpair.md)
- [工作階段範本常數](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [XblMultiplayerSessionCapabilities](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioncapabilities.md)