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

# XGameSave Provider Initialize 方法參考

> XGameSave 包裝函式 Provider.Initialize 方法的參考資料，此方法會準備遊戲存檔提供者，並同步處理指定使用者的所有容器。

# Microsoft.Xbox.Wrappers.XGameSave.Provider.Initialize

初始化遊戲存檔包裝函式，並同步處理指定使用者的所有容器。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT Initialize(XUserHandle userHandle,
                   const std::string& serviceConfigurationId);
```

<a id="parametersSection" />

### 參數

*userHandle*   \_In\_<br />類型：XUserHandle

XBOX Live 使用者帳戶的控制代碼。

*serviceConfigurationId*  \_In\_<br />類型：std::string

遊戲的服務設定識別碼 (SCID)。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

此方法成功時會傳回 **S\_OK**，失敗時則會傳回下列 HRESULT 代碼：

* **E\_GS\_USER\_CANCELED**
* **E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE**
* **E\_GS\_NO\_ACCESS**
* **E\_GS\_NO\_SERVICE\_CONFIGURATION**

<a id="remarksSection" />

## 備註

您必須先呼叫此方法，才能呼叫 `Provider` 類別中的任何其他方法。

您不應在遊戲的 UI 執行緒上呼叫此方法，因為它可能會封鎖，並可能在同步處理使用者的遊戲存檔時向使用者顯示 UI。

若要從指定容器中的指定 Blob 載入資料，請呼叫 [Load](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load)。

<a id="requirementsSection" />

## 需求

**標頭：** xgamesavewrappers.hpp

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

<a id="seealsoSection" />

## 另請參閱

[Microsoft.Xbox.Wrappers.XGameSave.Provider](/zh-TW/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)<br />[XGameSave 包裝函式成員](/zh-TW/reference/system/Wrappers/xgamesave_wrapper_members)


## Related topics

- [Initialize](/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [XGameSave Provider Initialize method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [Referencia del método Initialize de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [XGameSaveInitializeProviderResult](/zh-CN/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult.md)
- [Save](/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)