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

# XSystemGetXboxLiveSandboxId

> XSystemGetXboxLiveSandboxId

# XSystemGetXboxLiveSandboxId

XBOX Live サンドボックス ID を取得します。

## Syntax

```cpp theme={null}
HRESULT XSystemGetXboxLiveSandboxId(  
         size_t sandboxIdSize,  
         char* sandboxId,  
         size_t* sandboxIdUsed  
)  
```

### Parameters

*sandboxIdSize*   \_In\_\
型: size\_t

*sandboxId* のサイズ (バイト単位)。この値は XSystem.h で定義されている **XSystemXboxLiveSandboxIdMaxBytes** 定数以上である必要があります。

*sandboxId*   \_Out\_writes\_bytes\_to\_(sandboxIdSize,\*sandboxIdUsed)\
型: char\*

サンドボックス ID を受け取る文字バッファー。

*sandboxIdUsed*   \_Out\_opt\_\
型: size\_t\*

返される *sandboxId* バッファーの実際のサイズ (バイト単位)。

### Return value

型: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

成功した場合は **S\_OK**、それ以外の場合はエラー コードを返します。エラー コードの一覧については、[エラー コード](https://docs.xbox.com/ja-jp/reference/errorcodes.md) を参照してください。*sandboxIdSize* が **XSystemXboxLiveSandboxIdMaxBytes** より小さい値に設定されているために関数が失敗した場合、戻り値は **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)** に設定されます。

## Remarks

TitleID およびサービス構成 ID (SCID) と共に、サンドボックス ID は XBOX Live タイトルおよびアプリケーションの開発にとって重要です。サンドボックス ID はサンドボックスを識別し、開発中に開発キットのコンテンツを分離します。コンテンツの分離により、タイトルの開発およびテスト用のクリーンな環境が確保されます。

> [!NOTE]
>
> サンドボックス ID は大文字と小文字を区別します。

XBOX デバイスと PC デバイスの場合、サンドボックス ID はデバイス上に保存されます。サンドボックス ID が見つからない場合や、サンドボックス ID にアクセスする権限がない場合、サンドボックス ID の既定値は 'RETAIL' になります。

ゲームが実際に小売環境で実行されている場合も、この関数は 'RETAIL' を返します。

## Requirements

**ヘッダー:** XSystem.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

* [タイム センシティブ スレッド](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[開発キット設定の構成 (NDA トピック)](https://docs.xbox.com/ja-jp/home/setup-install/dev-kit-settings/config-dev-kit-settings.md)\
[XBOX Live 開発用サンドボックスのセットアップ](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)\
[XSystemGetConsoleId](https://docs.xbox.com/ja-jp/reference/system/xsystem/functions/xsystemgetconsoleid.md)\
[XSystem](https://docs.xbox.com/ja-jp/reference/system/xsystem/xsystem_members.md)


## Related topics

- [XBOX services サンドボックスの詳細](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [コンソールの所在地の判定](https://docs.xbox.com/ja-jp/build/game-principles/localization/determining-console-geolocation.md)
- [XSystem (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xsystem/xsystem_members.md)
- [XGameGetXboxTitleId](https://docs.xbox.com/ja-jp/reference/system/xgame/functions/xgamegetxboxtitleid.md)
- [Xbox Live ID から PlayFab ID を取得](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/server/account-management/get-playfab-ids-from-xbox-live-ids.md)