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

Obtém o nome da localização do datacenter do servidor de streaming.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

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

O tamanho máximo do nome da localização do datacenter a ser retornado.
O `serverLocationNameSize` deve ser recuperado chamando [XGameStreamingGetServerLocationNameSize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize).

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

O nome da Região do Azure com o datacenter que hospeda o servidor XBOX de streaming.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retornará **S\_OK** se for bem-sucedido; caso contrário, retornará um código de erro.

**Erros potenciais**

| Código de erro | Valor do erro | Motivo do erro |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | O runtime do XGameStreaming não foi inicializado. Chame [XGameStreamingInitialize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminginitialize) antes de chamar outras APIs. |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x7A | *serverLocationSize* não é grande o suficiente para conter o nome completo da localização do servidor (e seu caractere nulo de terminação). |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | O computador atual não está em execução em um datacenter. |

Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

<a id="remarksSection" />

## Comentários

Antes de chamar esta função, você pode chamar [XGameStreamingGetServerLocationNameSize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize) para obter o tamanho do nome da localização do servidor e, assim, alocar um buffer.

Você pode utilizar a Região do Azure se o jogo quiser se conectar a um servidor de jogo hospedado no Azure PlayFab Multiplayer Servers e quiser uma latência mínima com seu servidor de jogo.

O erro `E_GAMESTREAMING_NO_DATACENTER` pode ocorrer quando um jogador está usando o Streaming do Console para fazer streaming do jogo a partir de seu XBOX doméstico.  Esse erro também pode ocorrer em um XBOX Developer Kit se você não tiver definido um valor de substituição.

Em um XBOX Developer Kit, você pode definir o `serverLocationName` que deve ser retornado durante os testes, na guia **Streaming** do **Developer Home**.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xgamestreaming.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingGetServerLocationNameSize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize)


## Related topics

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