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
