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

# XGameStreamingGetServerLocationName

> XGameStreamingGetServerLocationName

# XGameStreamingGetServerLocationName

Obtient le nom de l'emplacement du centre de données du serveur de diffusion en continu.

## Syntaxe

```cpp theme={null}
HRESULT XGameStreamingGetServerLocationName(
         size_t serverLocationNameSize,
         char* serverLocationName
)
```

### Paramètres

*serverLocationNameSize*   \_In\_\
Type : size\_t

Taille maximale du nom d'emplacement du centre de données à retourner.
La valeur `serverLocationNameSize` doit être obtenue en appelant [XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md).

*serverLocationName*   \_Out\_writes\_z\_(serverLocationNameSize)\
Type : char\*

Nom de la région Azure dont le centre de données héberge le serveur XBOX de diffusion en continu.

### Valeur de retour

Type : HRESULT

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur.

**Erreurs potentielles**

| Code d'erreur | Valeur d'erreur | Cause de l'erreur |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | Le runtime XGameStreaming n'a pas été initialisé. Appelez [XGameStreamingInitialize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) avant d'appeler d'autres API. |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x7A | *serverLocationSize* n'est pas assez grand pour contenir le nom complet de l'emplacement du serveur (et son caractère nul de fin). |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | La machine actuelle ne s'exécute pas dans un centre de données. |

Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](https://docs.xbox.com/fr-CA/reference/errorcodes.md).

## Remarques

Avant d'appeler cette fonction, vous pouvez appeler [XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md) pour obtenir la taille du nom de l'emplacement du serveur afin de pouvoir allouer une mémoire tampon.

Vous pouvez utiliser la région Azure si le jeu souhaite se connecter à un serveur de jeu hébergé sur Azure PlayFab Multiplayer Servers et veut une latence minimale avec son serveur de jeu.

L'erreur `E_GAMESTREAMING_NO_DATACENTER` peut se produire lorsqu'un joueur utilise la diffusion en continu à partir de la console pour diffuser le jeu depuis sa XBOX à domicile. Cette erreur peut également se produire sur une XBOX Developer Kit si vous n'avez pas défini de valeur de remplacement.

Sur une XBOX Developer Kit, vous pouvez définir le `serverLocationName` qui doit être retourné pendant les tests, dans l'onglet **Streaming** de **Developer Home**.

## Configuration requise

**En-tête :** xgamestreaming.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[XGameStreaming](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/xgamestreaming_members.md)\
[XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md)


## Related topics

- [XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md)
- [XGameStreaming (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/xgamestreaming_members.md)
- [Pratiques exemplaires de développement pour XBOX Game Streaming](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [Utilisation des wrappers C# pour les API du GDK dans votre projet Unity](https://docs.xbox.com/fr-CA/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameStreamingGetTouchBundleVersionNameSize](https://docs.xbox.com/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversionnamesize.md)