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

# PFMatchmakingTicketConfiguration

> 用于创建 PlayFab Multiplayer 匹配票证的配置数据，包括超时、队列名称以及延迟测量使用等选项。

定义匹配票证的配置。

## 语法

```cpp theme={null}
struct PFMatchmakingTicketConfiguration {  
    uint32_t timeoutInSeconds;  
    const char* queueName;  
    uint32_t membersToMatchWithCount;  
    const PFEntityKey* membersToMatchWith;  
}  
```

### 成员

**`timeoutInSeconds`**   uint32\_t

尝试为票证进行匹配的时长（秒）。

**`queueName`**   const char\*\
*is null-terminated*

匹配队列的名称。

**`membersToMatchWithCount`**   uint32\_t

预计加入该票证的其他特定用户的数量。

**`membersToMatchWith`**   const [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)\*\
*array of size `membersToMatchWithCount`*

预计加入该票证的其他特定用户的 PlayFab 实体密钥。

此字段用于指定预计加入该票证的其他特定用户的数量。通常，此列表代表一组希望一起匹配的好友或战队。在所有指定用户通过 [PFMultiplayerJoinMatchmakingTicketFromId](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md) 加入票证之前，无法找到匹配。

## 要求

**头文件：** PFMatchmaking.h

## 另请参阅

[PFMatchmaking 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)


## Related topics

- [PFMultiplayerCreateMatchmakingTicket](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreatematchmakingticket.md)
- [PFMultiplayer C/C++ API 概览 - PFMatchmaking.h](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Matchmaking SDK 快速入门](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [PFMatchmakingServerBackfillTicketConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingserverbackfillticketconfiguration.md)
- [Join Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/join-matchmaking-ticket.md)