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

# XPackageGetUserLocale

> XPackageGetUserLocale

# XPackageGetUserLocale

Obtiene la configuración regional actual del usuario.

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
HRESULT XPackageGetUserLocale(
    size_t localeSize,
    char* locale
)  
```

<a id="parametersSection" />

### Parámetros

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

Si se ejecuta correctamente, el tamaño de la cadena en *locale*.

*locale*   \_Out\_writes\_(localeSize)\
Tipo: char\*

Si se ejecuta correctamente, contiene la configuración regional del usuario.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

HRESULT de éxito o código de error.

<a id="remarksSection" />

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Esta función obtiene la configuración regional del usuario que más se aproxima a la configuración regional del paquete. Si no se declara información de configuración regional para el paquete, esta función se ejecuta correctamente pero no devuelve una configuración regional del usuario en `locale`. Si la configuración regional del paquete coincide con una configuración regional del usuario instalada, la función se ejecuta correctamente y devuelve la configuración regional del usuario en `locale`. Si la configuración regional del paquete no coincide exactamente con una configuración regional del usuario instalada, la función intenta encontrar la configuración regional del usuario instalada más parecida. Si la función no puede encontrar una coincidencia cercana, se produce un error; de lo contrario, la función se ejecuta correctamente y la configuración regional del usuario instalada más parecida se devuelve en `locale`.

Si usa la entrega inteligente para controlar qué idiomas se instalan para su juego, es posible que la configuración regional que el usuario ha establecido en la consola tenga fragmentos que no están instalados actualmente. Esto obliga a que un juego compruebe siempre que los fragmentos necesarios están instalados, y recurra a otro idioma si no lo están: un procedimiento que requiere un conocimiento considerable sobre las configuraciones regionales y cómo recurren a sus idiomas más cercanos. Esta función proporciona una manera de obtener la configuración regional actual del usuario, o la alternativa más parecida, sin necesidad de implementar su propio procedimiento de análisis y reserva de configuraciones regionales.

En el siguiente ejemplo de código se muestra cómo usar esta función.

```cpp theme={null}
char gameLocale[LOCALE_NAME_MAX_LENGTH];

// Get the best user locale that is installed
HRESULT hr = XPackageGetUserLocale(_countof(gameLocale), gameLocale);
if (SUCCEEDED(hr))
{
    printf("Game using locale: %s\n", gameLocale);
}
```

<a id="requirementsSection" />

## Requisitos

**Encabezado:** XPackage.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

<a id="seealsoSection" />

## Documentación conceptual

* [Entrega inteligente: especificadores de idioma](/build/core-features/common/packaging/intelligentdelivery-language)
* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Determinación de la configuración regional y el idioma de la consola](/build/game-principles/localization/determining-console-locale)

## Consulte también

[XPackage](/reference/system/xpackage/xpackage_members)\
[Instalación por streaming y entrega inteligente](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [Determinación de la configuración regional y el idioma de la consola](/es/build/game-principles/localization/determining-console-locale.md)
- [Información general sobre localización y globalización](/es/build/game-principles/localization.md)
- [XPackage](/es/reference/system/xpackage/xpackage_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [chat_manager::get_chat_users](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_chat_users.md)