> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblFormatSecureDeviceAddress

> XblFormatSecureDeviceAddress

# XblFormatSecureDeviceAddress

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

## 構文

```cpp theme={null}
HRESULT XblFormatSecureDeviceAddress(  
         const char* deviceId,  
         XblFormattedSecureDeviceAddress* address  
)  
```

### パラメーター

*deviceId*   \_In\_\
型: char\*

ローカル ゲーム プロセス/インスタンスのライフタイム全体を通じて、このデバイスを表す一意の ID。

*address*   \_Inout\_\
型: [XblFormattedSecureDeviceAddress\*](/reference/live/xsapi-c/multiplayer_c/structs/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionCurrentUserSetSecureDeviceAddressBase64](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetsecuredeviceaddressbase64.md)
- [XblFormattedSecureDeviceAddress](/ja-jp/reference/live/xsapi-c/multiplayer_c/structs/xblformattedsecuredeviceaddress.md)
- [XblMultiplayerConnectionAddressDeviceTokenPair](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerconnectionaddressdevicetokenpair.md)
- [セッションテンプレートの定数](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [XblMultiplayerPerformQoSMeasurementsArgs](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerperformqosmeasurementsargs.md)