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

# 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)。

每個提供者都持有資源，當不再需要這些資源或現有提供者已失效時，就必須加以清除。提供者可能因數個原因而失效，主要原因是在應用程式暫停期間，同一位使用者在另一部裝置上取走了內容。這會以 **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 工具](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-tools.md)
* [XGameSave API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/xgamesave.md)
* [時間敏感執行緒](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)\
[XGameSaveInitializeProvider](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md)\
[XGameSaveInitializeProviderAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md)\
[遊戲存檔偵錯](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-debugging.md)


## Related topics

- [Game Saves 工具](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-tools.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)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [Save](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)