跳轉到主要內容

XblFormatSecureDeviceAddress

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

語法

參數

deviceId   _In_
類型:char*
在本機遊戲處理程序/執行個體的存留期間代表此裝置的唯一識別碼。 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年10月6日