Skip to main content

XSystemGetXboxLiveSandboxId

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

Syntax

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 成功した場合は S_OK、それ以外の場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。sandboxIdSizeXSystemXboxLiveSandboxIdMaxBytes より小さい値に設定されているために関数が失敗した場合、戻り値は HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) に設定されます。

Remarks

TitleID およびサービス構成 ID (SCID) と共に、サンドボックス ID は XBOX Live タイトルおよびアプリケーションの開発にとって重要です。サンドボックス ID はサンドボックスを識別し、開発中に開発キットのコンテンツを分離します。コンテンツの分離により、タイトルの開発およびテスト用のクリーンな環境が確保されます。
サンドボックス ID は大文字と小文字を区別します。
XBOX デバイスと PC デバイスの場合、サンドボックス ID はデバイス上に保存されます。サンドボックス ID が見つからない場合や、サンドボックス ID にアクセスする権限がない場合、サンドボックス ID の既定値は ‘RETAIL’ になります。 ゲームが実際に小売環境で実行されている場合も、この関数は ‘RETAIL’ を返します。

Requirements

ヘッダー: XSystem.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

開発キット設定の構成 (NDA トピック)
XBOX Live 開発用サンドボックスのセットアップ
XSystemGetConsoleId
XSystem
最終更新日 2026年8月24日