XPackageGetUserLocale
取得目前的使用者地區設定。語法
參數
localeSize _In_類型:size_t 成功時,為 locale 中字串的大小。 locale _Out_writes_(localeSize)
類型:char* 成功時,包含使用者地區設定。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
locale 中傳回使用者地區設定。如果套件地區設定符合已安裝的使用者地區設定,此函式會成功,並在 locale 中傳回該使用者地區設定。如果套件地區設定與已安裝的使用者地區設定不完全相符,此函式會嘗試尋找最接近的已安裝使用者地區設定。如果此函式找不到相近的相符項目,就會發生錯誤;否則,此函式會成功,並在 locale 中傳回最接近的已安裝使用者地區設定。
如果您使用 Intelligent Delivery 控制為遊戲安裝哪些語言,使用者為主機設定的地區設定可能有目前尚未安裝的區塊。這要求遊戲必須一律確認所需的區塊已安裝,並在未安裝時改用其他語言:這個程序需要相當了解地區設定,以及它們如何回復為最接近的語言。此函式提供一種方式,讓您無需自行實作地區設定分析與回復程序,即可取得目前的使用者地區設定或最接近的回復地區設定。
下列程式碼範例示範如何使用此函式。
需求
標頭: XPackage.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機與 XBOX Series 主機概念文件
另請參閱
XPackage串流安裝與 Intelligent Delivery
