Skip to main content

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.
Essa função obtém a localidade do usuário que mais se aproxima da localidade do pacote. Se nenhuma informação de localidade for declarada para o pacote, essa função terá êxito, mas não retornará uma localidade do usuário em 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 Series

Documentação conceitual

Confira também

XPackage
Instalação por streaming e Intelligent Delivery
Last modified on October 6, 2026