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

# PFGameSaveFilesIsConnectedToCloud

> 返回用户是否已连接到云。如果在没有网络访问的情况下调用 PFGameSaveFilesAddUserWithUiAsync()，并且用户在 PFGameSaveFilesUiSyncFailedCallback 中选择了 PFGameSaveFilesUiSyncFailedUserAction::UseOffline，则用户可能会与云断开连接。如果另一台设备成为活动设备，用户也可能随时与云断开连接。与云断开连接后，如果想尝试连接到云，可以再次调用 PFGameSaveFilesAddUserWithUiAsync()。如果网络仍处于脱机状态，它将再次显示失败 UI。无需重新初始化游戏存档，但如果需要也可以这样做。与云断开连接期间，即使有网络访问，PFGameSaveFilesUploadWithUiAsync() 也不会执行任何操作，而只会在异步完成时返回 E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD。

返回用户是否已连接到云。如果在没有网络访问的情况下调用 PFGameSaveFilesAddUserWithUiAsync()，并且用户在 PFGameSaveFilesUiSyncFailedCallback 中选择了 PFGameSaveFilesUiSyncFailedUserAction::UseOffline，则用户可能会与云断开连接。如果另一台设备成为活动设备，用户也可能随时与云断开连接。与云断开连接后，如果想尝试连接到云，可以再次调用 PFGameSaveFilesAddUserWithUiAsync()。如果网络仍处于脱机状态，它将再次显示失败 UI。无需重新初始化游戏存档，但如果需要也可以这样做。与云断开连接期间，即使有网络访问，PFGameSaveFilesUploadWithUiAsync() 也不会执行任何操作，而只会在异步完成时返回 E\_PF\_GAMESAVE\_DISCONNECTED\_FROM\_CLOUD。

## 语法

```cpp theme={null}
HRESULT PFGameSaveFilesIsConnectedToCloud(  
    PFLocalUserHandle localUserHandle,  
    bool* isConnectedToCloud  
)  
```

### 参数

**`localUserHandle`**   PFLocalUserHandle

要返回其配额的本地用户。

**`isConnectedToCloud`**   bool\*<br />*output*

如果用户已连接到云，则设置为 true

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 要求

**头文件：** PFGameSaveFiles.h

## 另请参阅

[PFGameSaveFiles 成员](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [Game Saves 离线模式](/zh-CN/services/playfab/player-progression/game-saves/offline.md)
- [Game Saves UI 回调](/zh-CN/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [游戏存档快速入门](/zh-CN/services/playfab/player-progression/game-saves/quickstart.md)
- [Game Saves 错误处理常见问题](/zh-CN/services/playfab/player-progression/game-saves/error-handling-faq.md)
- [服务 C API 概览 - PFGameSaveFiles.h](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)