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

# XblMultiplayerSetSubscriptionsEnabled

> XblMultiplayerSetSubscriptionsEnabled

# XblMultiplayerSetSubscriptionsEnabled

显式启动或停止通过 RTA 的多人游戏服务连接。启用 RTA 订阅可实现：1. 当本地用户的会话使用 MultiplayerSession 对象发生更改时进行回调。使用 [XblMultiplayerAddSessionChangedHandler](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayeraddsessionchangedhandler) 添加处理程序。2. 当支撑此多人游戏订阅的 RTA 连接中断时自动从会话中移除成员。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerSetSubscriptionsEnabled(  
         XblContextHandle xblContext,  
         bool subscriptionsEnabled  
)  
```

### 参数

*xblContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本地用户的 XBOX Live 上下文。

*subscriptionsEnabled*   \_In\_\
类型：bool

为 true 时启用订阅，为 false 时停止订阅。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此方法会立即启用 RTA 连接，但要接收会话变更回调，必须在启用订阅后再次写入会话。

## 要求

**头文件：** multiplayer\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSubscriptionsEnabled](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersubscriptionsenabled.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [多人游戏会话目录概述](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerAddSessionChangedHandler](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayeraddsessionchangedhandler.md)
- [多人游戏任务](/zh-CN/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)