Skip to main content

​
XblFormatSecureDeviceAddress

对于不支持 SDA 的平台，根据唯一设备 ID 格式化安全设备地址。

​
语法

​
参数

deviceId   _In_
类型：char* 在本地游戏进程/实例的生命周期内表示此设备的唯一 ID。 address   _Inout_
类型：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
最后修改于 2026年8月13日

相关主题

XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64XblFormattedSecureDeviceAddressXblMultiplayerConnectionAddressDeviceTokenPair会话模板常量XblMultiplayerSessionCapabilities