Skip to main content

XStoreCreateContext

為指定的使用者建立市集內容。

語法

參數

user   _In_opt_
類型:XUserHandle
要為其建立市集內容的使用者。
此參數僅對 PC 遊戲為選用:只要傳遞 nullptr 值即可。在 PC 上,系統會自動使用登入 Microsoft Store 的使用者,並忽略此參數。 主機遊戲則需要有效的 XUser。
storeContextHandle   _Out_
類型:XStoreContextHandle*
成功時,包含已建立的市集內容。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

注意: 在主機上,此函式建立的 XStoreContextHandle 會在暫停或 Quick Resume 事件之後失效。為了安全地處理這些情況,建議您在遊戲從暫停狀態繼續時,關閉 XStoreContextHandle 並重新建立。
在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
當您使用完此函式建立的 XStoreContextHandle 時,必須使用 XStoreCloseContextHandle 將其關閉。未關閉控制代碼會導致記憶體流失。在許多 XStore API 呼叫中,市集內容可用來識別要擷取其資訊的使用者。下列程式碼片段示範如何建立市集內容。

需求

標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XStore
XStoreCloseContextHandle
XStoreRegisterGameLicenseChanged
Last modified on October 6, 2026