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

# Serveurs de jeu à partir d'une entité de titre

> Authentifiez-vous en tant qu'entité de titre dans le SDK PlayFab Services à l'aide de PFAuthenticationGetEntityWithSecretKeyAsync pour appeler les API réservées aux serveurs sur Win32.

# Accéder à PlayFab avec une entité de titre

De la même manière que vous pouvez vous connecter en tant que joueur et effectuer des appels PlayFab, vous pouvez vous authentifier en tant qu'entité de titre et effectuer des appels PlayFab par son intermédiaire. Les entités de titre peuvent utiliser certaines fonctions qui ne sont pas disponibles pour les entités de joueur. Bon nombre de ces fonctions sont préfixées par le mot "server", par exemple ServerAddPlayerTag.

L'obtention d'un handle d'entité de titre suit les mêmes étapes d'initialisation que la connexion en tant que joueur. Pour plus de détails, consultez la section "Initialisation" de l'article [Démarrage rapide pour Win32](/fr/services/playfab/sdks/c/quickstart-win32).

Remarque : pour le moment, les fonctions serveur ne sont disponibles que dans la version Win32 du SDK.

## Authentifier une entité de titre

Après avoir créé un **PFServiceConfigHandle** lors des étapes initiales, vous pouvez obtenir un handle d'entité de titre en appelant [**PFAuthenticationGetEntityWithSecretKeyAsync**](/fr/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeyasync). Une fois l'appel d'obtention d'entité terminé avec succès, il renvoie **S\_OK** ainsi qu'un **PFEntityHandle**. Ce processus est similaire à la connexion en tant que joueur. Le type de retour **PFEntityHandle** est le même, sauf que dans ce cas, le handle d'entité représente une entité de titre plutôt qu'une entité de joueur. Nous pouvons appeler cette entité un serveur de jeu.

```cpp theme={null}
    PFAuthenticationGetEntityRequest request{};
    XAsyncBlock async{};

    // Add your own error handling when FAILED(hr) == true
    HRESULT hr = PFAuthenticationGetEntityWithSecretKeyAsync(
        serviceConfigHandle,
        secretKey, // title specific secret key
        &request,
        &async
    );

    hr = XAsyncGetStatus(&async, true); // This is doing a blocking wait for completion, but you can use the XAsyncBlock to set a callback instead for async style usage

    PFEntityHandle entityHandle;
    hr = PFAuthenticationGetEntityWithSecretKeyGetResult(
        &async,
        &entityHandle
    );
```

## Appels de service

Une fois le serveur de jeu créé, vous pouvez effectuer des appels au back-end PlayFab. Voici un exemple d'ajout de balises de joueur à un joueur spécifique du titre.

```cpp theme={null}
    XAsyncBlock async{};
    PFSegmentsAddPlayerTagRequest request{};
    addSegmentRequest.PlayFabId = "ABCDEF123456";
    addSegmentRequest.tagName = "tagName";
    HRESULT hr = PFSegmentsServerAddPlayerTagAsync(entityHandle, &request, &async);
    hr = XAsyncGetStatus(&async, true);
```

Comme dans l'exemple AddPlayerTag, bon nombre des fonctions utilisées par un serveur de jeu consistent à obtenir ou à modifier des données de joueur. Cette fonction nécessite l'ID PlayFab du joueur concerné. Les clients connectés peuvent fournir les ID PlayFab, ou le serveur peut les récupérer directement auprès de PlayFab via des appels tels que GetPlayFabIDsFromXboxLiveIDs.

## Référence

[Documentation de référence de l'API](/fr/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [Cycle de vie d'une région de build de serveur multijoueur](/fr/services/playfab/multiplayer/servers/multiplayer-build-region-lifecycle.md)
- [Tâches multijoueurs](/fr/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Allouer des serveurs de jeu et connecter le débogueur Visual Studio](/fr/services/playfab/multiplayer/servers/allocating-game-servers-and-configuring-vs-debugging-tools.md)
- [Fichiers d'entité](/fr/services/playfab/live-service-management/game-configuration/entities/entity-files.md)
- [Utiliser des objets d'entité pour stocker des données de joueur](/fr/services/playfab/live-service-management/game-configuration/entities/entity-objects.md)