Skip to main content

​
XblFormatSecureDeviceAddress

Formats a secure device address given a unique device id for platforms that don’t support SDAs.

​
Syntax

​
Parameters

deviceId   _In_
Type: char* A unique id to represent this device for the lifetime of the local game process/instance. address   _Inout_
Type: XblFormattedSecureDeviceAddress* Passes back the formatted secure device address.

​
Return value

Type: HRESULT HRESULT return code for this API operation.

​
Remarks

Formats the deviceId string according to the following recommendation: Generate 16 random bytes(e.g., a GUID) to be used for the lifetime of the local game process/instance to uniquely represent the device. Format the ‘secureDeviceAddress’ to be a string with the prefix “AAAAAAAA” (8 capital letter As) followed by the 32 character hexadecimal representation of the random bytes(upper or lower case letters don’t matter, nor does the byte order if the bytes are an actual structured GUID). For example, “AAAAAAAA00112233445566778899AABBCCDDEEFF”. Call XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64 using the formatted SDA to set the SDA for the user.

​
Requirements

Header: multiplayer_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

​
See also

multiplayer_c
Last modified on August 4, 2026

Related topics

XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64XblFormattedSecureDeviceAddressSession template constantsXblMultiplayerManagerLobbySessionSetSynchronizedHostXblMultiplayerManagerGameSessionSetSynchronizedHost