Skip to main content

XGameSaveGetContainerInfo

擷取 XGameSaveProvider 中容器的資訊。

語法

參數

provider   _In_
類型:XGameSaveProviderHandle
包含所需容器的 XGameSaveProvider 控制代碼。 containerName   _In_z_
類型:char*
要擷取資訊的容器名稱,若找到則只會傳回一個結果。如果需要多個容器,請使用 XGameSaveEnumerateContainerInfo 或 XGameSaveEnumerateContainerInfoByName。 context   _In_opt_
類型:void*
作為內容的呼叫物件指標。 callback   _In_
類型:XGameSaveContainerInfoCallback*
用來判斷 XGameSaveContainerInfo 呼叫結果並從中收集資料的回呼函式。

傳回值

類型:HRESULT 函式結果

常見錯誤

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
容器是中繼資料的集合,也是其中 Blob 集合的參考點。如果事先知道容器名稱,就可以使用此 API 只傳回該容器的資訊。這對於取回玩家的特定資訊很有用,不必在每次需要資訊時都要求所有資訊。您可以在 XGameSaveContainerInfo 結構中找到 XGameSaveContainer 的組成。

需求

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

概念文件

另請參閱

XGameSave
XGameSaveCreateContainer
XGameSaveContainerInfo
偵錯遊戲存檔
Last modified on October 6, 2026