> ## 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.

# XGameSaveCloseProvider

> XGameSaveCloseProvider

# XGameSaveCloseProvider

釋放 XGameSaveProvider 所持有的資源。

## 語法

```cpp theme={null}
void XGameSaveCloseProvider(  
         XGameSaveProviderHandle provider  
)  
```

### 參數

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

要關閉的 XGameSaveProvider 控制代碼。

### 傳回值

類型：void

## 備註

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

每個提供者都持有資源，當不再需要這些資源或現有提供者已失效時，就必須加以清除。提供者可能因數個原因而失效，主要原因是在應用程式暫停期間，同一位使用者在另一部裝置上取走了內容。這會以 **E\_GS\_HANDLE\_EXPIRED** 表示，且任何 XGameSave API 都可能傳回此值。正確的處理方式是關閉提供者，然後重新初始化，並提示使用者處理任何可能的衝突問題。

```cpp theme={null}
XGameSaveProviderHandle _provider; 
 
void Sample::_Uninitialize() 
{ 
    if (_provider) 
    { 
        XGameSaveCloseProvider(_provider); 
        _provider = nullptr; 
    } 
} 
```

## 需求

**標頭：** XGameSave.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [Game Saves 工具](/zh-TW/build/core-features/common/game-save/game-saves-tools)
* [XGameSave API 概觀](/zh-TW/build/core-features/common/game-save/xgamesave)
* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveInitializeProvider](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeprovider)\
[XGameSaveInitializeProviderAsync](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync)\
[遊戲存檔偵錯](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [Game Saves 工具](/zh-TW/build/core-features/common/game-save/game-saves-tools.md)
- [XGameSave API 概觀](/zh-TW/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members.md)
- [適用於 GDK 的 Unity C# API 包裝函式](/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameSaveInitializeProvider](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md)