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

<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 récupérée en appelant [XGameStreamingGetServerLocationNameSize](/fr/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize).

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

Nom de la région Azure contenant le centre de données qui héberge le serveur XBOX de streaming.

<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/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 null de fin). |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | L'ordinateur actuel ne s'exécute pas dans un centre de données. |

Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr/reference/errorcodes).

<a id="remarksSection" />

## Remarques

Avant d'appeler cette fonction, vous pouvez appeler [XGameStreamingGetServerLocationNameSize](/fr/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize) pour obtenir la taille du nom de l'emplacement du serveur afin d'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 souhaite une latence minimale avec son serveur de jeu.

L'erreur `E_GAMESTREAMING_NO_DATACENTER` peut se produire lorsqu'un joueur utilise le streaming depuis la console pour diffuser le jeu depuis sa XBOX à domicile.  Cette erreur peut également se produire sur un kit de développement XBOX si vous n'avez pas défini de valeur de remplacement.

Sur un kit de développement XBOX, vous pouvez définir la valeur `serverLocationName` qui doit être retournée 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/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingGetServerLocationNameSize](/fr/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize)


## Related topics

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