> ## 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 的平台，根据唯一设备 ID 格式化安全设备地址。

## 语法

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

### 参数

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

在本地游戏进程/实例的生命周期内表示此设备的唯一 ID。

*address*   \_Inout\_\
类型：[XblFormattedSecureDeviceAddress\*](/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetsecuredeviceaddressbase64.md)
- [XblFormattedSecureDeviceAddress](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblformattedsecuredeviceaddress.md)
- [XblMultiplayerConnectionAddressDeviceTokenPair](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerconnectionaddressdevicetokenpair.md)
- [会话模板常量](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [XblMultiplayerSessionCapabilities](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioncapabilities.md)