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

# XblMultiplayerManagerCancelMatch

> XblMultiplayerManagerCancelMatch

# XblMultiplayerManagerCancelMatch

如果存在匹配请求，则在服务器上取消该请求。

## 语法

```cpp theme={null}
void XblMultiplayerManagerCancelMatch(  
)  
```

### 参数

### 返回值

类型：void

## 备注

此函数取消先前提交的匹配票证。如果匹配票证的状态设置为 `XblMultiplayerMatchStatus::None`、`XblMultiplayerMatchStatus::Expired`、`XblMultiplayerMatchStatus::Canceled` 或 `XblMultiplayerMatchStatus::Failed`，或者如果不同的主机提交了匹配票证，则忽略此函数。\
如果调用了此函数，则在服务器上取消匹配票证之前，匹配票证的状态设置为 `XblMultiplayerMatchStatus::Canceling`。\
有关匹配票证的详细信息，请参阅[多人游戏概念概述](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)。

## 要求

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

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

## 另请参阅

[multiplayer\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerFindMatch](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerfindmatch.md)\
[XblMultiplayerManagerMatchStatus](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagermatchstatus.md)


## Related topics

- [multiplayer_manager_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)
- [XblMultiplayerManagerMatchStatus](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagermatchstatus.md)
- [XblMultiplayerManagerFindMatch](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerfindmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [Cancel Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/cancel-matchmaking-ticket.md)