Skip to main content

XPackageGetUserLocale

获取当前用户区域设置。

语法

参数

localeSize   _In_
类型:size_t
成功时,locale 中字符串的大小。 locale   _Out_writes_(localeSize)
类型:char*
成功时,包含用户区域设置。

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
此函数获取与程序包区域设置最匹配的用户区域设置。如果未为程序包声明任何区域设置信息,则此函数成功但不会在 locale 中返回用户区域设置。如果程序包区域设置与已安装的用户区域设置匹配,则该函数成功并在 locale 中返回用户区域设置。如果程序包区域设置与已安装的用户区域设置不完全匹配,则该函数会尝试查找最匹配的已安装用户区域设置。如果该函数找不到近似匹配项,则会发生错误;否则,该函数成功并在 locale 中返回最匹配的已安装用户区域设置。 如果你正在使用智能交付来控制为你的游戏安装哪些语言,则用户为主机设置的区域设置对应的区块可能当前未安装。这要求游戏始终验证所需的区块是否已安装,并在未安装时回退到另一种语言:这需要相当多的关于区域设置及其如何回退到最接近语言的知识。此函数提供了一种获取当前用户区域设置或最匹配回退项的方法,而无需实现你自己的区域设置分析和回退过程。 以下代码示例演示如何使用此函数。

要求

头文件: XPackage.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念性文档

另请参阅

XPackage
流式安装和智能交付
最后修改于 2026年8月24日