Skip to main content

XSystemGetXboxLiveSandboxId

擷取 XBOX Live 沙箱 ID。

語法

參數

sandboxIdSize _In_
類型:size_t
sandboxId 的大小 (以位元組為單位)。此值必須等於或大於 XSystem.h 中定義的 XSystemXboxLiveSandboxIdMaxBytes 常數。 sandboxId _Out_writes_bytes_to_(sandboxIdSize,*sandboxIdUsed)
類型:char*
將接收沙箱 ID 的字元緩衝區。 sandboxIdUsed _Out_opt_
類型:size_t*
傳回之 sandboxId 緩衝區的實際大小 (以位元組為單位)。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼清單,請參閱錯誤碼。如果函式因 sandboxIdSize 設定為小於 XSystemXboxLiveSandboxIdMaxBytes 的值而失敗,傳回值會設定為 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)。

備註

沙箱 ID 與 TitleID 和服務設定 ID (SCID) 一起,對 XBOX Live 遊戲和應用程式的開發至關重要。沙箱 ID 會識別您的沙箱,沙箱在開發期間為您的開發套件提供內容隔離。內容隔離可確保您擁有乾淨的環境來開發和測試您的遊戲。
沙箱 ID 區分大小寫。
對於 XBOX 和 PC 裝置,沙箱 ID 儲存在裝置上。如果找不到沙箱 ID,或您沒有存取沙箱 ID 的權限,沙箱 ID 預設為 ‘RETAIL’。 如果您的遊戲實際上是在零售環境中執行,此函式也會傳回 ‘RETAIL’。

需求

標頭: XSystem.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

設定開發套件設定 (NDA 主題)
設定 XBOX Live 開發的沙箱
XSystemGetConsoleId
XSystem
Last modified on October 6, 2026