> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveDeleteContainer

> XGameSaveDeleteContainer

# XGameSaveDeleteContainer

從雲端儲存體刪除 XGameSaveContainer。

## 語法

```cpp theme={null}
HRESULT XGameSaveDeleteContainer(  
         XGameSaveProviderHandle provider,  
         const char* containerName  
)  
```

### 參數

*provider*   \_In\_\
類型：XGameSaveProviderHandle

包含要刪除之容器的 XGameSaveProvider 控制代碼。

*containerName*   \_In\_z\_\
類型：char\*

要刪除之容器的名稱。

### 傳回值

類型：HRESULT

函式結果。

## 備註

> [!NOTE]
>
> 在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。

此作業有時可能執行緩慢，這在某種程度上取決於要刪除的資料大小。此作業會序列化，以確保資料始終保持一致的表示。此方法有非同步版本 [XGameSaveDeleteContainerAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md)。

```cpp theme={null}
void Sample::_DeleteContainer(const char* name) 
{ 
    HRESULT hr = XGameSaveDeleteContainer(_provider, name); 
    if (FAILED(hr)) 
    { 
        _HandleContainerErrors(name, hr); 
    } 
} 
```

## 需求

**標頭：** XGameSave.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[XGameSave](https://docs.xbox.com/zh-TW/reference/system/xgamesave/xgamesave_members.md)\
[XGameSaveDeleteContainerAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md)\
[遊戲存檔偵錯](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-debugging.md)


## Related topics

- [XGameSaveDeleteContainerAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md)
- [XGameSave API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/xgamesave.md)
- [XGameSave (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xgamesave/xgamesave_members.md)
- [XGameSaveDeleteContainerResult](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerresult.md)
- [XGameSaveContainerInfo](https://docs.xbox.com/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
