Skip to main content

XblFormatSecureDeviceAddress

SDA をサポートしないプラットフォーム向けに、一意のデバイス ID からセキュア デバイス アドレスを書式設定します。

構文

パラメーター

deviceId   _In_
型: char*
ローカル ゲーム プロセス/インスタンスのライフタイム全体を通じて、このデバイスを表す一意の ID。 address   _Inout_
型: XblFormattedSecureDeviceAddress*
書式設定されたセキュア デバイス アドレスを返します。

戻り値

型: HRESULT この API 操作の HRESULT 戻り値コード。

解説

次の推奨事項に従って deviceId 文字列を書式設定します。デバイスを一意に表すために、ローカル ゲーム プロセス/インスタンスのライフタイム中に使用する 16 バイトのランダム バイト (GUID など) を生成します。‘secureDeviceAddress’ を、プレフィックス “AAAAAAAA” (大文字の A 8 個) の後に、ランダム バイトの 32 文字の 16 進数表現が続く文字列として書式設定します (大文字と小文字は問いません。また、バイトが実際の構造化された GUID である場合、バイト順序も問いません)。たとえば、“AAAAAAAA00112233445566778899AABBCCDDEEFF” のようになります。書式設定された SDA を使用して XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64 を呼び出し、ユーザーの SDA を設定します。

要件

ヘッダー: multiplayer_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_c
最終更新日 2026年8月13日