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를 호출할 수 있습니다.

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