XPackageGetUserLocale
Obtém a localidade atual do usuário.Sintaxe
Parâmetros
localeSize _In_Tipo: size_t Em caso de sucesso, o tamanho da cadeia de caracteres em locale. locale _Out_writes_(localeSize)
Tipo: char* Em caso de sucesso, contém a localidade do usuário.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
locale. Se a localidade do pacote corresponder a uma localidade de usuário instalada, a função terá êxito e retornará a localidade do usuário em locale. Se a localidade do pacote não corresponder exatamente a uma localidade de usuário instalada, a função tentará localizar a localidade de usuário instalada mais próxima. Se a função não conseguir encontrar uma correspondência próxima, ocorrerá um erro; caso contrário, a função terá êxito e a localidade de usuário instalada mais próxima será retornada em locale.
Se você estiver usando a Intelligent Delivery para controlar quais idiomas são instalados para seu jogo, é possível que a localidade definida pelo usuário no console tenha partes que não estão instaladas no momento. Isso exige que um jogo sempre verifique se as partes necessárias estão instaladas e recorra a outro idioma caso não estejam: um procedimento que exige um conhecimento considerável sobre localidades e como elas recorrem aos idiomas mais próximos. Essa função fornece uma maneira de obter a localidade atual do usuário, ou a alternativa correspondente mais próxima, sem a necessidade de implementar sua própria análise de localidade e procedimento de fallback.
O exemplo de código a seguir demonstra como usar essa função.
Requisitos
Cabeçalho: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Intelligent Delivery: especificadores de idioma
- Threads sensíveis ao tempo
- Determinando a localidade e o idioma do console
Confira também
XPackageInstalação por streaming e Intelligent Delivery
