GetUserDefaultLocaleName 함수(winnls.h)

사용자 기본 로캘 이름을 검색합니다.

참고 애플리케이션은 Windows Vista 이상에서만 실행되도록 설계된 경우 GetUserDefaultLCID 를 기본 설정으로 이 함수를 호출해야 합니다.

 

구문

int GetUserDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

매개 변수

[out] lpLocaleName

이 함수가 로캘 이름을 검색하는 버퍼에 대한 포인터입니다.

[in] cchLocaleName

lpLocaleName으로 표시된 버퍼의 크기(문자 단위)입니다. 종료 null 문자를 포함하여 로캘 이름의 가능한 최대 길이는 LOCALE_NAME_MAX_LENGTH. 이 매개 변수에 제공하는 데 권장되는 크기입니다.

반환 값

성공하면 종료 null 문자를 포함하여 로캘 이름을 포함하는 버퍼의 크기를 반환합니다.

참고 단일 사용자 시스템에서 반환 값은 GetSystemDefaultLocaleName에서 반환한 값과 동일합니다.

 

함수가 성공하지 못하면 0을 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

• ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.

설명

이 함수는 사용자 지정 로캘에서 데이터를 검색할 수 있습니다. 데이터가 컴퓨터에서 컴퓨터로 또는 애플리케이션 실행 간에 동일하지는 않습니다. 애플리케이션이 데이터를 유지하거나 전송해야 하는 경우 영구 로캘 데이터 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

국가 언어 지원

국가 언어 지원 함수