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

# PFMultiplayerJoinMatchmakingTicketFromId

> Une uno o varios usuarios locales a un vale de emparejamiento de PlayFab Multiplayer existente mediante un identificador de vale y un nombre de cola compartidos por el creador inicial del vale.

Une uno o varios usuarios locales a un vale de emparejamiento mediante un identificador de vale y un nombre de cola.

## Sintaxis

```cpp theme={null}
HRESULT PFMultiplayerJoinMatchmakingTicketFromId(  
    PFMultiplayerHandle handle,  
    uint32_t localUserCount,  
    const PFEntityKey* localUsers,  
    const char* localUserAttributes,  
    const char* ticketId,  
    const char* queueName,  
    void* asyncContext,  
    PFMatchmakingTicketHandle* ticket  
)  
```

### Parámetros

**`handle`**   PFMultiplayerHandle

El identificador de la instancia de la API PFMultiplayer.

**`localUserCount`**   uint32\_t

El número de usuarios locales que se van a unir al vale.

**`localUsers`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\
*matriz de entrada de tamaño `localUserCount`*

La matriz de usuarios locales que se van a unir al vale.

**`localUserAttributes`**   char\*\
*matriz de entrada de tamaño `localUserCount`*

La matriz de cadenas de atributos de usuario local. Debe haber una cadena de atributos por cada usuario local. Cada cadena de atributos debe ser una cadena vacía o un objeto JSON serializado. Por ejemplo, `{"player_color":"blue","player_role":"tank"}`.

**`ticketId`**   char\*\
*termina en null*

El identificador del vale al que se va a unir.

**`queueName`**   char\*\
*termina en null*

La cola a la que pertenece el vale.

**`asyncContext`**   void\*\
*opcional*

Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización a esta llamada.

**`ticket`**   PFMatchmakingTicketHandle\*\
*salida asignada por la biblioteca*

El objeto de vale resultante.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentarios

La biblioteca envía de forma automática y asincrónica todos los usuarios locales especificados para que se unan al vale en el servicio de emparejamiento. Cada vez que cambia el estado del vale, se proporciona un [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange). El estado del vale se puede consultar en cualquier momento mediante [PFMatchmakingTicketGetStatus()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetstatus). El vale comienza inmediatamente en el estado `PFMatchmakingTicketStatus::Joining`. <br /><br /> Cuando el vale se completa, se proporciona un [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange). En ese momento, se encontró una coincidencia o el vale se detuvo debido a un error. Si se realiza correctamente, la coincidencia que se encontró se puede consultar mediante [PFMatchmakingTicketGetMatch()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetmatch).   <br /><br /> Si la creación del vale produce un error porque ya hay demasiados vales para los usuarios especificados, se cancelan de forma transparente esos vales pendientes y, después, se vuelve a intentar la creación del vale.

## Requisitos

**Encabezado:** PFMatchmaking.h

## Consulte también

[Miembros de PFMatchmaking](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)


## Related topics

- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMatchmakingTicketStatus](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/enums/pfmatchmakingticketstatus.md)
- [PFMatchmakingTicketConfiguration](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketconfiguration.md)
- [PFMultiplayerCreateMatchmakingTicket](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreatematchmakingticket.md)
- [Inicio rápido del SDK de Matchmaking](/es/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)