XPackageGetUserLocale
Obtiene la configuración regional actual del usuario.Sintaxis
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.
Valor devuelto
Tipo: HRESULT HRESULT de éxito o código de error.Comentarios
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.
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.
Requisitos
Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
- Entrega inteligente: especificadores de idioma
- Subprocesos sensibles al tiempo
- Determinación de la configuración regional y el idioma de la consola
Consulte también
XPackageInstalación por streaming y entrega inteligente