Windows.Gaming.XboxLive.StorageApiContract

从 GameSaveContainer 检索的命名游戏保存 blob 的集合。

异步游戏保存 blob 请求的状态结果。

类型：GameSaveErrorStatus

命名游戏保存 blob 的集合。

类型：**IMapView\<;String, IBuffer>;** \[JavaScript/C++\] | System.Collections.Generic.IReadOnlyDictionary\<;String, IBuffer>; \[.NET\]

包含关于游戏保存 blob 的信息。 调用 GameSaveBlobInfoQuery.GetBlobInfoAsync 以获取 **GameSaveBlobInfo** 实例。

blob 的名称。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\]

blob 大小，以字节为单位。

类型：**Number** \[JavaScript\] | System.UInt32 \[.NET\] | **uint32** \[C++\]

GameSaveBlobInfoQuery.GetBlobInfoAsync operation 操作的结果

异步游戏保存 blob 信息请求的状态结果。

类型：GameSaveErrorStatus

有关 GameSaveBlobInfoQuery 返回的 blob 的信息。

枚举 GameSaveContainer 中的 blob。

异步检索与此查询匹配的所有 blob 的信息。

类型：**IAsyncOperation\<;GameSaveBlobInfoGetResult>;**

异步检索与此查询匹配的 blob 的指定子集的信息。

类型：**Number** \[JavaScript\] | System.UInt32 \[.NET\] | **uint32** \[C++\] 类型：**Number** \[JavaScript\] | System.UInt32 \[.NET\] | **uint32** \[C++\] 类型：**IAsyncOperation\<;GameSaveBlobInfoGetResult>;**

检索匹配创建了 GameSaveBlobInfoQuery 对象的查询的 blob 的数目。

类型：**IAsyncOperation\<;UInt32>;**

包含表示单个保存游戏的数据 blob 的集合。

此 GameSaveContainer 的名称。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\]

存储此容器的提供程序。

类型：GameSaveProvider

创建在名称以指定前缀开头的容器中检索游戏保存 blob 的 GameSaveBlobInfoQuery 实例。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：GameSaveBlobInfoQuery

从容器异步检索 blob。

类型：**IIterable\<;String>;** \[JavaScript/C++\] | System.Collections.Generic.IEnumerable\<;String>; \[.NET\] 类型：**IAsyncOperation\<;GameSaveBlobGetResult>;**

按 *blobsToRead* 指定的从这个容器读取 blob。 传入 *blobsToRead* 的缓冲区必须大到足以存储 blob 数据。

类型：**IMapView\<;String, IBuffer>;** \[JavaScript/C++\] | System.Collections.Generic.IReadOnlyDictionary\<;String, IBuffer>; \[.NET\] 类型：**IAsyncOperation\<;GameSaveOperationResult>;**

类似于 SubmitUpdatesAsync，除了此方法在 **PropertySet** 上而不是映射视图上操作（或 C\# 字典）。

类型：IPropertySet 类型：**IIterable\<;String>;** \[JavaScript/C++\] | System.Collections.Generic.IEnumerable\<;String>; \[.NET\] 类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：**IAsyncOperation\<;GameSaveOperationResult>;**

提交一组对此容器中的游戏保存 blob 的更改。 更改可写入 blob 或现有 blob 的删除。 如果容器不存在，创建一个新的。 将自动应用所有写入和更新。 试图写入和删除同一个 blob 会导致错误。 每次调用仅可写入 16MB 数据。

类型：**IMapView\<;String, IBuffer>;** \[JavaScript/C++\] | System.Collections.Generic.IReadOnlyDictionary\<;String, IBuffer>; \[.NET\] 类型：**IIterable\<;String>;** \[JavaScript/C++\] | System.Collections.Generic.IEnumerable\<;String>; \[.NET\] 类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：**IAsyncOperation\<;GameSaveOperationResult>;**

关于游戏保存容器的信息。

显示给用户用于此游戏保存的名称。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\]

游戏保存容器上次修改的日期和时间。

类型：**Date** \[JavaScript\] | System.DateTimeOffset \[.NET\] | Windows::Foundation::DateTime \[C++\]

此游戏保存容器的名称。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\]

指示容器是否需要先与 SubmitUpdatesAsync 或 SubmitPropertySetUpdatesAsync 同步才可以提交更新。

类型：**Boolean** \[JavaScript\] | System.Boolean \[.NET\] | Platform::Boolean \[C++\]

以字节为单位的游戏保存容器及其 blob 的总大小。

类型：**Number** \[JavaScript\] | System.UInt64 \[.NET\] | **uint64** \[C++\]

GameSaveContainerInfoQuery 操作的结果。

异步游戏保存容器信息请求的状态结果。

类型：GameSaveErrorStatus

GameSaveContainerInfoQuery 返回的容器信息的集合。

类型：**IVectorView\<;GameSaveContainerInfo>;** \[JavaScript/C++\] | System.Collections.Generic.IReadOnlyList\<;GameSaveContainerInfo>; \[.NET\]

枚举游戏保存提供程序中的游戏保存容器。

异步检索与此查询匹配的所有游戏保存容器的信息。 容器枚举按照最近修改最先显示的顺序。

类型：**IAsyncOperation\<;GameSaveContainerInfoGetResult>;**

异步检索与此查询匹配的游戏保存容器的指定子集的信息。 容器枚举按照最近修改最先显示的顺序。

类型：**Number** \[JavaScript\] | System.UInt32 \[.NET\] | **uint32** \[C++\] 类型：**Number** \[JavaScript\] | System.UInt32 \[.NET\] | **uint32** \[C++\] 类型：**IAsyncOperation\<;GameSaveContainerInfoGetResult>;**

检索匹配创建了此 GameSaveContainerInfoQuery 对象的查询的容器的数目。

类型：**IAsyncOperation\<;UInt32>;**

游戏保存操作返回的成功和失败代码。

| **Abort** | **abort** | 0x80004004 | 操作已中止。 |

| **BlobNotFound** | **blobNotFound** | 0x80830008 | 操作失败，因为容器中找不到给定名称的 blob。 |

| **ContainerNotInSync** | **containerNotInSync** | 0x8083000A | 由于容器不在本地存在操作失败。 此错误可能在向需要同步的容器提交更新时出现，读取、删除或 blob 查询未在容器中发出。 |

| **ContainerSyncFailed** | **containerSyncFailed** | 0x8083000B | 操作失败，因为容器无法同步。 这表明用户由于不想再等待或由于网络故障已取消容器同步且用户未重试。 此错误可能由 DeleteContainerAsync、ReadAsync、GetAsync 或 GameSaveBlobInfoQuery 操作返回。 |

| **InvalidContainerName** | **invalidContainerName** | 0x80830001 | 指定的容器名称为空，包含无效的字符，或者太长。 |

| **NoAccess** | **noAccess** | 0x80830002 | 操作失败，因为标题没有容器存储空间的写入访问权限。 |

| **NoXboxLiveInfo** | **noXboxLiveInfo** | 0x80830009 | 操作失败，因为标题不具有正确的标题 id 或服务配置 id。 |

| **ObjectExpired** | **objectExpired** | 0x8083000D | 操作失败，因为该应用已暂停，对象不再有效。 若要在恢复后执行游戏保存操作，应用必须请求具有 GetForUserAsync 或 GetSyncOnDemandForUserAsync 的新 GetForUserAsync。 |

| **Ok** | **ok** | 0 | 操作已成功完成。 |

| **OutOfLocalStorage** | **outOfLocalStorage** | 0x80830003 | 操作失败，因为没有足够的可用本地存储。 尽管用户被提供了释放一些本地存储的机会，但他们选择不执行此操作。 |

| **ProvidedBufferTooSmall** | **providedBufferTooSmall** | 0x80830007 | 操作失败，由于为读取 blob 提供的缓冲区太小而无法接收 blob。 |

| **QuotaExceeded** | **quotaExceeded** | 0x80830006 | 操作失败，因为更新会导致存储空间超过其配额。 使用 IGameSaveProvider.GetRemainingBytesInQuotaAsync 查询剩余配额空间。 |

| **UpdateTooBig** | **updateTooBig** | 0x80830005 | 操作失败，因为更新包含多于 16MB 的数据。 |

| **UserCanceled** | **userCanceled** | 0x80830004 | 操作失败，因为用户已取消操作。 |

| **UserHasNoXboxLiveInfo** | **userHasNoXboxLiveInfo** | 0x8083000C | 操作失败，因为没有与用户帐户关联的 Xbox Live 信息。 GetForUserAsync 或 GetSyncOnDemandForUserAsync 可能返回此错误。 |

异步游戏保存操作的结果。

异步游戏保存操作的状态结果。

类型：GameSaveErrorStatus

**GameSaveProvider** 用于创建、保存、枚举和加载 Xbox Live 游戏保存。

调用新 GameSaveProvider 实例，返回自应用程序上次运行后更改的容器的名称。

类型：**IVectorView\<;String>;** \[JavaScript/C++\] | System.Collections.Generic.IReadOnlyList\<;String>; \[.NET\]

与此游戏保存提供程序及其游戏保存容器关联的用户。

类型：**User**

创建新 GameSaveContainer 以存储游戏保存。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：GameSaveContainer

创建枚举此游戏保存提供程序中的所有容器的 GameSaveContainerInfoQuery 实例。

类型：GameSaveContainerInfoQuery

创建枚举名称以指定前缀开头的此游戏保存提供程序中的容器的 GameSaveContainerInfoQuery 实例。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：GameSaveContainerInfoQuery

异步删除指定的游戏保存容器。

类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：**IAsyncOperation\<;GameSaveOperationResult>;**

为指定的用户获取游戏保存提供程序。

类型：User 类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：**IAsyncOperation\<;GameSaveProviderGetResult>;**

获取此游戏保存提供程序的用户配额的剩余字节。

类型：**IAsyncOperation\<;Int64>;**

获取按需同步容器的部分同步的游戏保存提供程序。

类型：User 类型：**String** \[JavaScript\] | System.String \[.NET\] | Platform::String \[C++\] 类型：**IAsyncOperation\<;GameSaveProviderGetResult>;**

GetForUserAsync 或 GetSyncOnDemandForUserAsync 的结果。 操作。

异步游戏保存提供程序请求的状态结果。

类型：GameSaveErrorStatus

成功游戏保存提供程序请求返回的 GameSaveProvider 实例。