XblFormatSecureDeviceAddress

针对不支持 SDA 的平台,在给定唯一设备 ID 的情况下设置安全设备地址的格式。

语法

HRESULT XblFormatSecureDeviceAddress(  
         const char* deviceId,  
         XblFormattedSecureDeviceAddress* address  
)  

参数

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