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

# PFMatchmakingTicketGetTicketId

> Recupera el identificador de vale único asignado a un vale de emparejamiento de PlayFab Multiplayer, que se usa para unirse al vale o hacer referencia a él desde otras sesiones de cliente.

Proporciona el identificador del vale.

## Sintaxis

```cpp theme={null}
HRESULT PFMatchmakingTicketGetTicketId(  
    PFMatchmakingTicketHandle ticket,  
    const char** id  
)  
```

### Parámetros

**`ticket`**   PFMatchmakingTicketHandle

El identificador del vale de emparejamiento.

**`id`**   char\*\*\
*salida asignada por la biblioteca*

El identificador del vale.

### 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()](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentarios

El identificador del vale será una cadena vacía si aún no se ha establecido. Esto puede ocurrir en una de las siguientes condiciones:

* El vale está en el estado `PFMatchmakingTicketStatus::Creating`
* El vale está en el estado `PFMatchmakingTicketStatus::Failed` debido a un error al enviar un vale al servicio de emparejamiento
* El vale se canceló antes de que pudiera enviarse al servicio de emparejamiento

## Requisitos

**Encabezado:** PFMatchmaking.h

## Consulte también

[Miembros de PFMatchmaking](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)


## Related topics

- [Información general de la API de C/C++ de PFMultiplayer - PFMatchmaking.h](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Notas de la versión del SDK de C++ de PlayFab Multiplayer](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Get Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/get-matchmaking-ticket.md)
- [MatchmakingTicket.TicketId](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/TicketId.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md)
