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

# XGameStreamingGetServerLocationName

> XGameStreamingGetServerLocationName

# XGameStreamingGetServerLocationName

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### 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](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize).

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

<a id="retvalSection" />

### 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](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminginitialize) 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](/fr-CA/reference/errorcodes).

<a id="remarksSection" />

## Remarques

Avant d'appeler cette fonction, vous pouvez appeler [XGameStreamingGetServerLocationNameSize](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize) 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**.

<a id="requirementsSection" />

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

<a id="seealsoSection" />

## Voir aussi

[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingGetServerLocationNameSize](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize)


## Related topics

- [XGameStreamingGetServerLocationName](/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationname.md)
- [XGameStreamingGetServerLocationNameSize](/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md)