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

# XGameSaveSubmitBlobDelete

> XGameSaveSubmitBlobDelete

# XGameSaveSubmitBlobDelete

將刪除動作新增至遊戲存檔 XGameSaveUpdate。

## 語法

```cpp theme={null}
HRESULT XGameSaveSubmitBlobDelete(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName  
)  
```

### 參數

*updateContext*   \_In\_\
類型：XGameSaveUpdateHandle

將在其中刪除 Blob 的 **XGameSaveUpdate** 控制代碼。

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

要刪除的 Blob 名稱。

### 傳回值

類型：HRESULT

函式結果

## 備註

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

進行此呼叫之前，您必須先成功呼叫 [XGameSaveCreateUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate)。

此 API 的儲存部分旨在以安全、可靠且交易式的方式，輕鬆地將資料從遊戲傳輸至持續性儲存體。我們希望確保容器的備份資料始終保持一致，因此希望整個作業以不可部分完成的方式成功或失敗。我們不希望發生部分更新，導致某些 Blob 資料與容器內的其他資料不一致。為此，我們提供了一個更新內容，Blob 的寫入和刪除會提交至該內容，準備就緒後再提交整個內容。實際上看起來如下：

XGameSaveUpdate 會透過 [XGameSaveSubmitBlobWrite](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) 和 [XGameSaveSubmitBlobDelete](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) 填入要對容器內 Blob 執行的寫入和刪除動作。呼叫 [XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate) 即可完成更新。

如需使用方式，請參閱 [XGameSaveCreateUpdate 範例](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate#example)。

## 需求

**標頭：** 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](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobWrite](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobwrite)\
[偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveSubmitBlobDelete](/ko/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md)
- [XGameSaveSubmitBlobWrite](/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md)